1. 环境准备:匹配ThinkPHP要求的PHP版本与扩展
ThinkPHP对PHP版本有明确要求(如ThinkPHP 8.1需PHP≥8.0),需通过php -v确认版本兼容性。安装必要扩展:php-mysqlnd(数据库)、php-mbstring(多字节字符串)、php-xml(XML处理)、php-curl(HTTP请求)、php-gd(图像处理)等,避免因扩展缺失导致功能异常。
2. Web服务器配置:正确处理PHP请求与URL重写
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(指向文档根目录下的脚本文件)。mod_rewrite模块(sudo a2enmod rewrite),确保项目目录允许.htaccess覆盖(AllowOverride All),否则路由规则无法生效。3. 目录权限:避免敏感文件泄露与写入失败
nginx、Apache默认apache):sudo chown -R nginx:nginx /path/to/thinkphp。chmod -R 755(确保Web服务器可读取),runtime目录(缓存、日志)需可写入(chmod -R 775 runtime),但需限制其他用户的写入权限(如chmod -R 755),防止非法修改。4. 安全加固:降低框架与服务器风险
.env文件(app_debug = false),避免暴露详细错误信息(如数据库结构、代码逻辑)。runtime目录访问:通过Nginx配置deny all;禁止直接访问runtime目录(如location ^~ /runtime/ { deny all; }),防止敏感数据泄露。listen 443 ssl;),加密数据传输(避免SQL注入、XSS等攻击)。validate类对用户输入进行验证(如邮箱、手机号格式),防止SQL注入(推荐使用PDO预处理或查询构造器)。5. 兼容性问题:解决版本冲突与路径问题
mbstring、xml扩展,若缺失会导致框架无法启动(通过php -m检查扩展是否加载)。php-fpm(sudo yum install php-fpm),并正确配置location ~ \.php$块(确保fastcgi_pass指向正确的PHP-FPM socket)。setenforce 0),或通过chcon命令修改目录安全上下文(如chcon -R -t httpd_sys_rw_content_t /path/to/thinkphp/runtime)。6. 进程管理:确保应用持续运行
sudo yum install supervisor),创建配置文件(/etc/supervisor/conf.d/thinkphp.conf),设置autostart=true(开机自启)、autorestart=true(崩溃自动重启),并通过sudo supervisorctl update应用配置。7. 日志排查:快速定位部署问题
/var/log/nginx/error.log):解决Web服务器配置错误(如404、502)。/var/log/php-fpm/error.log):排查PHP解析问题(如扩展缺失、语法错误)。runtime/log目录):获取框架级别的错误信息(如数据库连接失败、路由未匹配),便于针对性解决。