PHP 开发环境配置 - 码剑客

配置 PHP 开发环境：Windows/Linux/macOS 安装、php.ini 常用扩展、Composer 与换源、内置服务器、调试与常见报错排查。

PHP 8.2 / 8.3更新于 2026-10-29共 29 条

安装与版本管理

Windows 安装 PHP 8.3，安装后需把 php.exe 所在目录加入 PATH

winget install PHP.PHP.8.3

Windows 想要开箱即用的 Apache/Nginx + MySQL + PHP 组合，可装 Laragon

winget install LeNgocKhoa.Laragon

macOS 用 Homebrew、Ubuntu 用 ondrej 源安装 PHP 与常用扩展

# macOS
brew install php@8.3
brew link --force php@8.3
# Ubuntu / Debian
sudo apt update && sudo apt install -y php8.3 php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl

确认版本并列出已加载扩展

php -v
php -m

查看当前使用的 php.ini 路径，改配置前先确认文件位置

php --ini

镜像源与代理

全局把 Composer 官方源换成阿里云镜像，安装速度提升明显

composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

确认镜像配置已写入全局 config.json

composer config -g --list | findstr repos

只对当前项目换源，避免影响其它工程的私有仓库配置

composer config repos.packagist composer https://mirrors.tencent.com/composer/

私有仓库配置账号密码认证，凭据保存在全局 auth.json

composer config -g http-basic.repo.example.com username password

Windows 下让 composer 走代理；macOS/Linux 用 export

set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

环境变量与扩展

把 PHP 的 bin 目录写入 PATH，命令行才能直接调用 php

# Windows
setx PATH "%PATH%;C:\php"
# macOS / Linux
echo 'export PATH="/opt/homebrew/opt/php@8.3/bin:$PATH"' >> ~/.zshrc

在 php.ini 中启用常用扩展，改完需重启 PHP-FPM 或 Web 服务

extension=mbstring
extension=openssl
extension=pdo_mysql
extension=curl

Windows 下指定扩展目录，否则 extension= 配置会加载失败

extension_dir = "C:\php\ext"

确认 CLI 与 Web 环境读取的是否为同一个 php.ini

php -i | findstr "Loaded Configuration File"

查看当前内存上限，处理大文件或大批量任务前先确认

php -r "echo ini_get('memory_limit');"

创建工程与验证

不依赖 Web 服务器，快速验证 CLI 环境可用

php -r "echo PHP_VERSION, PHP_EOL;"

用 Composer 创建 Laravel 工程并启动开发服务器

composer create-project laravel/laravel demo
cd demo
php artisan serve

PHP 内置服务器，零配置预览工程（仅用于开发）

php -S 127.0.0.1:8000 -t public

按 lock 文件还原依赖，并刷新自动加载映射

composer install
composer dump-autoload

校验 composer.json 并检查依赖的已知安全漏洞

composer validate
composer audit

编辑器与插件

安装 Xdebug 调试扩展与 Intelephense 智能提示

code --install-extension xdebug.php-debug
code --install-extension bmewburn.vscode-intelephense-client

php.ini 中启用 Xdebug，配合 IDE 断点调试

zend_extension=xdebug
xdebug.mode=debug,develop
xdebug.client_port=9003

安装编码规范检查工具，统一团队代码风格

composer global require squizlabs/php_codesniffer

常见问题排查

php 命令不存在或版本不对时，先确认 PATH 命中的可执行文件

# Windows
where php
# macOS / Linux
which -a php

只做语法检查，快速定位白屏或 500 的语法错误

php -l index.php

开发环境临时打印全部错误，避免错误被吞掉

php -d display_errors=1 -d error_reporting=E_ALL -S 127.0.0.1:8000

依赖包下载损坏时清理缓存并重装

composer clear-cache
composer install --no-cache

一键检查网络、镜像、证书与 Composer 配置问题

composer diagnose

Windows 终端输出中文乱码时切换代码页为 UTF-8

chcp 65001