PHP Logo PHP 开发环境配置

PHP、Web 服务器、数据库完整配置指南

安装方案选择

推荐方案：Windows 用户建议使用集成环境（XAMPP/PhpStorm），Linux/Mac 用户建议单独安装
集成环境（推荐新手）

一键安装 PHP+MySQL+Apache/Nginx

  • 配置简单
  • 开箱即用
  • 适合本地开发

代表：XAMPP、phpStudy、WampServer

单独安装（推荐进阶）

分别安装各组件，灵活配置

  • 版本可控
  • 配置灵活
  • 接近生产环境

PHP + Nginx/Apache + MySQL

Docker（推荐专业）

容器化部署，环境隔离

  • 环境一致
  • 快速切换
  • 便于协作

使用 Docker Compose 编排

集成环境下载

XAMPP（跨平台推荐）

Apache Friends 出品的跨平台集成环境

  • 包含 Apache + MySQL + PHP + Perl
  • 支持 Windows/Linux/Mac
  • 社区活跃，文档丰富
官方下载
安装后访问：
http://localhost
管理面板：http://localhost/dashboard
phpStudy（国内推荐）

国产 PHP 集成环境，中文界面

  • 中文界面，操作简单
  • 多版本 PHP 切换
  • 支持 Nginx/Apache
官方下载

适合国内用户，有免费版和付费版

WampServer WampServer

Windows 平台专用集成环境

  • Windows 专用
  • 托盘菜单管理
  • 扩展开启方便
官方下载
Laragon（轻量推荐）

轻量快速的现代 PHP 开发环境

  • 轻量快速
  • 自动虚拟主机
  • 支持多 PHP 版本
官方下载

单独安装 PHP

PHP 官方下载
Windows 用户

下载非线程安全 (NTS) 版本用于生产环境，线程安全 (TS) 版本用于 Apache 模块

  • PHP 8.3 - 最新版本
  • PHP 8.2 - 稳定版本（推荐）
  • PHP 8.1 - 长期支持
Windows 版下载
Linux/Mac 用户
# Ubuntu/Debian
sudo apt install php php-cli php-mbstring php-xml php-curl

# CentOS/RHEL
sudo yum install php php-cli php-mbstring php-xml

# Mac (使用 Homebrew)
brew install php
环境变量配置（Windows）
# 添加 PHP 安装目录到 Path
C:\php
验证安装
php -v
php -m          # 查看已加载模块

Composer 包管理

Composer 是什么：PHP 的依赖管理工具，类似于 npm（Node.js）或 pip（Python）
安装 Composer

Composer 官方安装程序

官方下载
Windows 安装后验证：
composer --version
配置国内镜像：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
常用命令
# 初始化项目
composer init

# 安装包
composer require 包名

# 安装所有依赖
composer install

# 更新依赖
composer update

# 查看已安装包
composer show

# 自动加载
composer dump-autoload

数据库配置

MySQL MySQL

最流行的关系型数据库

下载 官网
MariaDB MariaDB

MySQL 的分支，完全兼容

下载 官网
PostgreSQL PostgreSQL

强大的开源关系型数据库

下载 官网
数据库管理工具
phpMyAdmin

Web 版 MySQL 管理

DBeaver

通用数据库工具

HeidiSQL

轻量 MySQL 客户端

Navicat

专业数据库管理

开发工具 (IDE)

PHP PhpStorm（强烈推荐）
最专业 付费

JetBrains 出品的专业 PHP IDE

特点：
  • 智能代码补全
  • 强大的调试功能
  • 数据库工具集成
  • Laravel/Symfony 支持
官方下载
学生可申请免费教育许可证
VS Code Visual Studio Code
免费 轻量

微软出品的通用代码编辑器

必备 PHP 插件：
  • PHP Intelephense - 智能提示
  • PHP Debug - 调试支持
  • Laravel Blade Snippets - Blade 模板
  • PHPUnit - 单元测试
官方下载
Sublime Sublime Text

轻量快速的文本编辑器

  • 启动速度快
  • 多光标编辑
  • 丰富的插件
官方下载
NetBeans Apache NetBeans

开源免费的 PHP IDE

  • 完全免费
  • PHP 支持良好
  • 内置调试器
官方下载

常用 PHP 框架

Laravel Laravel

最流行的 PHP 框架，优雅简洁

  • 优雅的语法
  • 丰富的生态
  • 文档完善
文档 
composer create-project laravel/laravel 项目名
Symfony Symfony

企业级 PHP 框架，组件化设计

  • 高度模块化
  • 长期支持
  • 性能优秀
文档 
symfony new 项目名
ThinkPHP ThinkPHP

国产 PHP 框架，中文文档友好

  • 中文文档
  • 易学易用
  • 国内社区活跃
文档 
composer create-project topthink/think 项目名
CodeIgniter CodeIgniter

轻量级 PHP 框架，性能出色

  • 体积小
  • 性能高
  • 配置简单
文档
Hyperf Hyperf

高性能 PHP 协程框架

  • 协程支持
  • 微服务架构
  • 高性能
文档
Yii2 Yii2

高效、安全的 PHP 框架

  • Gii 代码生成
  • 安全性高
  • 性能优秀
文档

常见问题与注意事项

对比项集成环境单独安装
安装难度 简单，一键安装 较复杂，需分别配置
灵活性 较低，版本固定 高，可自由选择版本
适用场景 本地开发、学习 生产环境、高级开发

建议：新手使用集成环境快速上手，进阶后学习单独配置

配置国内镜像源可以大幅提升速度：

# 全局配置阿里云镜像
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

# 或配置腾讯云镜像
composer config -g repos.packagist composer https://mirrors.cloud.tencent.com/composer/

# 查看配置
composer config -g repos

  • PHP 8.3 - 最新版本，包含最新特性
  • PHP 8.2 - 当前推荐版本，稳定且支持新特性
  • PHP 8.1 - 长期支持版本，企业使用较多
  • PHP 7.4 - 已停止支持，仅用于维护老项目
注意：PHP 7.x 和 8.0 已停止官方支持，建议使用 PHP 8.1+

框架适合场景学习难度
Laravel 快速开发、创业项目 中等
Symfony 企业级大型应用 较高
ThinkPHP 国内项目、快速上手 较低
Hyperf 高性能、微服务 较高

建议：初学者从 Laravel 或 ThinkPHP 开始

常见原因和解决方案：

  1. 端口被占用 - 80 端口可能被 IIS 或其他服务占用
    • 修改 httpd.conf 中的 Listen 端口
    • 或关闭占用 80 端口的服务
  2. 缺少 VC++ 运行库 - 安装 Visual C++ Redistributable
  3. 权限问题 - 以管理员身份运行 XAMPP
  4. 防火墙阻止 - 在防火墙中允许 Apache
# 查看端口占用
netstat -ano | findstr :80

环境验证命令

安装完成后，打开命令提示符运行以下命令验证：

# 验证 PHP
php -v

# 查看已加载模块
php -m

# 验证 Composer
composer --version

# 创建测试文件
echo "" > C:\xampp\htdocs\info.php

# 浏览器访问 http://localhost/info.php 查看 PHP 信息