PHP环境能运行phpinfo()不等于业务稳定，常见问题包括扩展加载失败（需匹配TS/NTS、架构、VC库）、MySQL连接时localhost与127.0.0.1协议差异、文件上传三配置（file_uploads、upload_max_filesize、post_max_size）缺一不可、中文路径权限及编码问题，以及隐式默认值导致的静默失效。
PHP独立环境能跑起来，不等于能稳定跑通业务逻辑。很多新手在本地装完phpstudy或XAMPP，打开phpinfo()看到绿色页面就以为万事大吉，结果一跑表单提交就空白，一连MySQL就报错，一上传文件就超时——问题基本不出在“会不会装”，而出在几个默认配置和路径细节上。
Apache/PHP版本不匹配导致模块加载失败
常见错误现象是启动服务时报PHP Startup: Unable to load dynamic library，或者php -v能执行但Web页面里extension=mbstring不生效。根本原因是PHP扩展（.dll或.so）编译时依赖的VC运行库、线程安全（TS/NTS）标识、架构（x86/x64）必须和当前PHP二进制完全一致。
- Windows下用phpstudy时，别直接复制别人打包好的
ext目录——先看phpinfo()顶部的Thread Safety（是enabled还是disabled）、Architecture（x86还是x64） - Linux下用源码编译PHP，
./configure参数里--enable-mbstring要和--with-apxs2同时指定，否则Apache加载的是旧版PHP模块 - 扩展启用后仍不生效？检查
php.ini里extension_dir路径是否指向真实存在的目录，且末尾没多余斜杠（如C:\php\ext\比C:\php\ext更容易出错）
MySQL连接失败：localhost ≠ 127.0.0.1
用PDO或mysqli连MySQL时，host=localhost在Windows和部分Linux发行版上会走命名管道或socket，而host=127.0.0.1强制走TCP/IP。如果MySQL配置了skip-networking或bind-address=127.0.0.1但未开放端口，localhost可能连得上，127.0.0.1反而拒绝连接，反之亦然。
- 测试方法：命令行执行
mysql -h localhost -u root -p和mysql -h 127.0.0.1 -u root -p，看哪个报错 - PHP代码中统一用
127.0.0.1，避免隐式协议切换；若必须用localhost，确认MySQL的my.ini或my.cnf里socket路径与PHP的pdo_mysql.default_socket值一致 - phpstudy等集成环境默认MySQL端口是3306，但有些老项目硬编码了3307——检查
mysqli_connect()第四个参数是否显式传了端口号
文件上传失败：三个配置项缺一不可
表单提交带<input type="file">后，$_FILES为空或error=2（UPLOAD_ERR_FORM_SIZE），往往不是前端HTML写错了，而是PHP.ini里三处限制被忽略：
立即学习“PHP免费学习笔记（深入）”；
-
file_uploads = On（默认是On，但某些精简版环境会关掉） -
upload_max_filesize = 2M（注意单位是M不是MB，且不能写成2MB） -
post_max_size = 8M（必须≥upload_max_filesize，否则整个POST请求会被截断）
改完记得重启Apache/Nginx，仅重启PHP-FPM不够；验证方式是输出ini_get('upload_max_filesize')和ini_get('post_max_size')，别只信配置文件名。
中文路径/文件名乱码：不仅是字符集问题
用file_get_contents('中文目录/文件.txt')报错或返回空，或者move_uploaded_file()移动后文件名变成?????.jpg，根源常在操作系统层而非PHP本身。
- Windows下Apache服务默认以SYSTEM用户运行，对中文路径权限不足；解决办法是把Apache设为“以当前登录用户身份运行”（服务属性→登录→选“此账户”）
- Linux下确保Web服务器用户（如www-data）对目标目录有读写权限，且文件系统挂载时支持UTF-8（
mount | grep utf8） - PHP内部处理时，
iconv()或mb_convert_encoding()对路径无效；真正有效的是用urlencode()转义路径再urldecode()还原，或统一用拼音/英文命名上传目录
环境配置的坑，90%都藏在“默认值”和“隐式行为”里。比如max_execution_time设成0不代表无限，而是继承父进程限制；session.save_path没写绝对路径，PHP可能往/tmp写却因权限被拒——这些细节不会报错，只会让功能静默失效。动手前先跑一遍php -i | grep -E "(upload|post|file|session|mysql)"，比反复试错快得多。
