如何为PHP项目搭建开发环境？

wen PHP项目 2026-06-18 3

本文目录导读：

如何为PHP项目搭建开发环境？

方案一：集成环境（最简单，新手首选）
方案二：手动搭建（适合进阶、自定义配置）
方案三：Docker 容器化（隔离性最好，适合团队协作）
选择建议

为PHP项目搭建开发环境，核心是配置好 Web服务器、PHP解释器 和 数据库 这三件套，根据你的操作系统和项目复杂度,有以下几种主流方案。

集成环境（最简单，新手首选）

这种方式一键安装所有组件，适合快速上手、学习PHP或进行简单项目开发。

推荐工具：

XAMPP：跨平台（Win/Mac/Linux），最流行,界面友好。
WampServer：仅限Windows，托盘管理,切换PHP版本方便。
MAMP：Mac平台首选,也有Windows版。
PHPStudy：国内常用，支持Windows和Linux,工具集丰富。

操作步骤（以XAMPP为例）：

下载安装：访问 Apache Friends 下载对应系统的版本,双击安装。
启动服务：打开XAMPP Control Panel，点击 Apache 和 MySQL 的 Start 按钮。
放置代码：找到安装目录下的 htdocs 文件夹（C:\xampp\htdocs\）,把你的PHP项目文件夹放在这里。
访问项目：打开浏览器，输入 http://localhost/你的项目文件夹名/ 即可。

手动搭建（适合进阶、自定义配置）

如果你想深入了解每个组件的配合，或者需要特定版本的PHP/扩展,可以手动配置。

环境：Windows

下载解压：分别下载 Apache（.zip版）、PHP（线程安全版 .zip）、MySQL（.zip版或安装版）。
配置Apache：修改 conf/httpd.conf 文件：
- 设置 ServerRoot 为Apache解压路径。
- 添加PHP支持：LoadModule php_module "C:/php/php8apache2_4.dll"
- 添加PHP类型：AddHandler application/x-httpd-php .php
- 设置PHP路径：PHPIniDir "C:/php"
配置PHP：
- 复制 php.ini-development 重命名为 php.ini。
- 取消注释并设置 extension_dir = "ext"。
- 启用常用扩展：extension=mysqli、extension=mbstring、extension=curl 等。
启动服务：在Apache的 bin 目录下打开cmd，运行 httpd.exe，打开浏览器输入 http://localhost 测试。
配置数据库：安装MySQL，设置root密码，配置 php.ini 中的 mysqli 扩展连接。

环境：macOS

macOS自带Apache和PHP，但版本通常较旧，推荐使用 Homebrew 管理。

# 安装 Homebrew（如果没装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装最新版PHP（例如8.3）
brew install php
# 安装并启动MySQL
brew install mysql
brew services start mysql
# 启动PHP-FPM（如果使用nginx）或Apache模块
brew services start php

环境：Linux（以Ubuntu/Debian为例）

# 更新包列表
sudo apt update
# 安装 Apache、PHP、MySQL
sudo apt install apache2 php libapache2-mod-php php-mysql mysql-server
# 启动服务
sudo systemctl start apache2
sudo systemctl start mysql
# 设置开机自启
sudo systemctl enable apache2
sudo systemctl enable mysql
# 配置MySQL（设置root密码等）
sudo mysql_secure_installation

Docker 容器化（隔离性最好，适合团队协作）

使用Docker可以保证开发环境与线上完全一致，避免“在我电脑上是好的”问题。

前提：安装 Docker Desktop。

使用官方镜像手动搭（灵活）

创建一个 docker-compose.yml 文件：

version: '3.8'
services:
  web:
    image: php:8.2-apache   # 包含Apache和PHP
    ports:
      - "8080:80"
    volumes:
      - ./项目目录:/var/www/html   # 将项目代码映射到容器内
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: myapp
    ports:
      - "3306:3306"
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

然后在项目目录下运行 docker-compose up -d，访问 http://localhost:8080。

使用Laravel Sail（专门为Laravel优化）

如果使用Laravel框架，其内置了Sail工具,封装度更高。

# 在Laravel项目目录下
./vendor/bin/sail up -d

选择建议

适用场景	推荐方案	理由
PHP初学者、快速测试、简单项目	XAMPP / MAMP	省心，开箱即用
学习运维、自定义插件、老项目维护	手动搭建	能理解底层原理
现代框架（Laravel、Symfony）、团队协作	Docker	环境一致性好，不会污染本机
本地需要多个不同PHP版本	Docker 或 PHPStudy	切换版本方便