ThinkPHP CentOS部署注意事项

在CentOS上部署ThinkPHP虽然看似简单，但稍有不慎便可能遇到问题。从环境兼容到安全配置，每个环节都有讲究。下面将关键步骤逐一说明，帮助您减少部署中的弯路。

环境准备：PHP版本与扩展必须匹配

ThinkPHP对PHP版本有硬性要求——以ThinkPHP 8.1为例，需要PHP≥8.0。部署前先用php -v确认版本是否达标。扩展方面，像php-mysqlnd（数据库）、php-mbstring（多字节字符串）、php-xml（XML处理）、php-curl（HTTP请求）、php-gd（图像处理）等都需要安装，缺少任何一个都可能引发功能异常。

Web服务器配置：搞定URL重写和PHP请求

无论使用Nginx还是Apache，核心都是让请求正确转发到ThinkPHP的入口文件。

• Nginx：需要添加try_files $uri $uri/ /index.php$query_string;规则，确保PATHINFO支持（否则路由失效）。同时配置PHP-FPM监听，例如使用Unix socket时写成fastcgi_pass unix:/run/php-fpm/www.sock，并正确设置fastcgi_param SCRIPT_FILENAME指向文档根目录下的脚本文件。
• Apache：先启用mod_rewrite模块（sudo a2enmod rewrite），再确保项目目录允许.htaccess覆盖（AllowOverride All），否则路由规则不会生效。

目录权限：既要能读写，又要防泄露

权限设置需要平衡——过松不安全，过紧应用无法运行。

• 将项目目录所有者改为Web服务器用户（Nginx默认nginx，Apache默认apache）：sudo chown -R nginx:nginx /path/to/thinkphp。
• 权限建议：项目目录设置为755（Web服务器可读取），runtime目录（缓存、日志）需要写入权限，设置为775即可，但必须限制其他用户写入（例如chmod -R 755），防止被恶意篡改。

安全加固：降低框架和服务器风险

生产环境不同于测试机，安全不可忽视。

• 关闭调试模式：修改.env文件，将app_debug设为false，否则错误信息会暴露数据库结构、代码逻辑等敏感内容。
• 限制runtime目录访问：在Nginx配置中加入location ^~ /runtime/ { deny all; }，禁止直接访问该目录，防止敏感数据泄露。
• 使用HTTPS：通过Let’s Encrypt申请免费SSL证书，配置Nginx/Apache启用HTTPS（listen 443 ssl;），加密传输数据，有效抵御SQL注入、XSS等攻击。
• 输入过滤：利用ThinkPHP的validate类对用户输入进行验证（如邮箱、手机号格式），操作数据库时推荐使用PDO预处理或查询构造器，从源头防止SQL注入。

兼容性问题：版本冲突和路径错误

这类问题往往最隐蔽，也最容易让人困扰。

• 确认PHP扩展是否真正加载——例如mbstring、xml扩展，ThinkPHP 8依赖它们，缺失会导致框架启动失败。使用php -m检查最为稳妥。
• PHP文件不被解析？检查Nginx是否安装php-fpm（sudo yum install php-fpm），并确保location ~ .php$块配置正确，fastcgi_pass指向正确的PHP-FPM socket。
• 如果启用SELinux，遇到“Permission denied”错误时，可临时设为宽松模式（setenforce 0）测试，或者使用chcon命令修改目录安全上下文：chcon -R -t httpd_sys_rw_content_t /path/to/thinkphp/runtime。

进程管理：确保应用持续运行

对于队列、定时任务等后台进程，推荐使用Supervisor管理。安装Supervisor（sudo yum install supervisor），创建配置文件如/etc/supervisor/conf.d/thinkphp.conf，设置autostart=true（开机自启）、autorestart=true（崩溃自动重启），然后执行sudo supervisorctl update应用配置，省心且稳定。

日志排查：快速定位问题

部署遇到问题不必慌张，日志是最有效的工具。

• Nginx错误日志（/var/log/nginx/error.log）：解决Web服务器层面的配置错误，如404、502。
• PHP-FPM错误日志（/var/log/php-fpm/error.log）：排查PHP解析问题，如扩展缺失、语法错误。
• ThinkPHP日志（runtime/log目录）：获取框架级别的错误信息，如数据库连接失败、路由未匹配，针对性解决即可。