推荐用 vlucas/phpdotenv 加载 .env 文件隔离环境配置，避免硬编码和误提交敏感信息；动态端口、router.php 静态资源处理、扩展依赖校验及 Docker 中 PHP-FPM 与 CLI 环境强制一致是关键实践。
用 .env 文件 + vlucas/phpdotenv 隔离配置
不同环境（开发、测试、生产）最常冲突的是数据库地址、API 密钥、调试开关这些。硬编码在代码里或靠条件判断 if ($_SERVER['APP_ENV'] === 'prod') 极易出错，且容易误提交敏感信息。
推荐用 vlucas/phpdotenv 加载 .env 文件，让 PHP 自动把环境变量注入 $_ENV 和 $_SERVER：
composer require vlucas/phpdotenv
项目根目录放 .env（不提交到 Git），内容示例：
DB_HOST=localhost DB_PORT=3306 APP_DEBUG=true JWT_SECRET=dev-secret-key
入口文件（如 index.php）开头加载：
立即学习“PHP免费学习笔记（深入）”；
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__); $dotenv->load();
之后直接用 $_ENV['DB_HOST'] 或 getenv('DB_PORT')。注意：.env 不能包含空格等非法字符，键名不要用 -，推荐全大写+下划线。
用 php -S 内置服务器时避免端口/路由冲突
本地开发常用 php -S localhost:8000 router.php，但多人协作或并行启动多个项目时，8000 端口极易被占。更麻烦的是，router.php 若没正确处理静态资源路径，会返回 404 或错误的 PHP 源码。
解决方法：
- 端口动态化：用
php -S localhost:$PORT，配合.env设置DEV_PORT=8081 -
router.php必须显式检查文件存在性，否则所有请求都进 PHP：
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|xml|svg|pdf|txt|woff2|ttf)$/', $_SERVER["REQUEST_URI"])) {
return false; // 让内置服务器自己 serve 静态文件
}
// 否则走框架或主逻辑
include __DIR__ . '/index.php';
扩展与函数行为差异导致的运行时冲突
PHP 版本升级（如 7.4 → 8.1）、扩展启停（如 opcache、redis、mbstring）会直接让代码报错或行为异常。典型例子：json_encode() 在 ext-json 关闭时返回 null 而非抛异常；mb_strtolower() 缺失扩展时会 fallback 到 strtolower()，中文变乱码。
上线前必须检查：
- 用
extension_loaded('mbstring')或function_exists('mb_strtolower')做运行时兜底 - 在
composer.json的require中明确声明扩展依赖，如"ext-mbstring": "*" - 用
php -m和php -v核对目标环境实际加载的扩展和版本
Docker 中 PHP-FPM 与 CLI 环境不一致
很多团队用 Docker 运行 PHP-FPM 处理 HTTP 请求，但用宿主机或另起容器跑 php artisan migrate 或 phpunit —— 这两个环境的 php.ini、扩展、include_path 往往不同，导致命令行能跑通，网页却报错，或者反之。
关键动作：
- 所有 CLI 任务（迁移、队列、测试）必须在同个 PHP-FPM 容器内执行：
docker exec -it myapp-php-fpm php artisan migrate - 确保
php-fpm.conf和cli/php.ini同步：Dockerfile 中统一 COPY 一份 ini 文件到两个位置 - 用
phpinfo()页面和php -i输出对比两处的Loaded Configuration File和Additional .ini files parsed
环境隔离不是靠“尽量一样”，而是靠“强制一致”。任何绕过容器执行 CLI 命令的操作，都是给线上埋雷。
