在 CentOS 上使用 PHP 框架的通用流程
- 准备环境:安装 Web 服务器(Apache 或 Nginx)、PHP 与常用扩展、Composer(PHP 依赖管理)。
- 创建项目:用 Composer 新建框架项目(如 Laravel、Symfony、ThinkPHP 等)。
- 配置 Web 服务器与 PHP-FPM:按框架要求开启 URL 重写、将 PHP 请求转发给 PHP-FPM。
- 数据库与配置:安装并初始化 MySQL/MariaDB,在框架中配置数据库连接。
- 权限与 SELinux:设置目录权限,必要时调整 SELinux 上下文。
- 测试与日志:访问入口页,检查 Web/php-fpm/应用 日志定位问题。
- 部署与维护:使用进程管理、自动化部署与质量检查,便于持续交付。
以 ThinkPHP 为例的 Nginx 部署步骤
-
安装软件包
- 安装 EPEL 与 Nginx:sudo yum install -y epel-release nginx
- 安装 PHP 与扩展(以 PHP 7.4 为例,使用 Remi 仓库):
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php74
sudo yum install -y php php-fpm php-mysqlnd php-gd php-curl php-xml php-mbstring php-zip
- 启动服务:
sudo systemctl start nginx php-fpm
sudo systemctl enable nginx php-fpm
-
配置 Nginx 站点
- 新建站点:/etc/nginx/conf.dphp.conf
- 示例配置:
server {
listen 80;
server_name your_domain.com;
root /path/tophp/public; # 建议指向 public 目录
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ .php$ {
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /.ht { deny all; }
}
- 检查并重载:sudo nginx -t && sudo systemctl reload nginx
-
部署项目与数据库
- 放置代码:将 ThinkPHP 项目放到 /path/tophp,确保入口为 public/index.php。
- 安装依赖:cd /path/tophp && composer install
- 数据库(示例):
CREATE DATABASE your_db CHARACTER SET utf8mb4;
CREATE USER ‘your_user’@‘localhost’ IDENTIFIED BY ‘your_pass’;
GRANT ALL PRIVILEGES ON your_db.* TO ‘your_user’@‘localhost’;
FLUSH PRIVILEGES;
- 配置连接:编辑 .env 或 config/database.php,设置 DB_HOST、DB_NAME、DB_USER、DB_PASS、DB_PORT。
-
权限与 SELinux(如启用)
- 目录权限:
sudo chown -R nginx:nginx /path/tophp
sudo find /path/tophp -type d -exec chmod 755 {} ;
sudo find /path/tophp -type f -exec chmod 644 {} ;
- SELinux(如为 Enforcing):
sudo restorecon -R /path/tophp
或按需设置 httpd 可写目录(如 runtime、日志):
sudo setsebool -P httpd_can_network_connect_db 1
sudo semanage fcontext -a -t httpd_sys_rw_content_t “/path/tophp/runtime(/.*)?”
sudo restorecon -R /path/tophp/runtime
以 ThinkPHP 为例的 Apache 部署要点
-
安装与启用模块
- 安装:sudo yum install -y httpd
- 启用模块:sudo a2enmod rewrite(或确保 httpd.conf 中 LoadModule rewrite_module 已启用)
- 启动:sudo systemctl start httpd && sudo systemctl enable httpd
-
虚拟主机配置
- 示例:/etc/httpd/conf.dphp.conf
<VirtualHost *:80>
ServerName your_domain.com
DocumentRoot /path/tophp/public
<Directory /path/tophp/public>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
ErrorLog /var/log/httpdphp_error.log
CustomLog /var/log/httpdphp_access.log combined
- 重载:sudo systemctl reload httpd
其他常见框架与通用建议
- 快速创建项目(Composer)
- Laravel:composer create-project laravel/laravel my-app
- Symfony:composer create-project symfony/framework-standard-edition my-app
- ThinkPHP:composer create-project topthink tp
- Zend Framework:composer create-project zendframework/skeleton-application my-app
- FuelPHP:composer create-project fuel/fuel my-app
- 部署要点
- 始终将 Web 根目录指向框架的 public/;启用 URL 重写(Laravel/Symfony 需隐藏 index.php)。
- 配置日志路径与权限,便于排查:Web 服务日志、php-fpm 日志、应用日志。
- 生产建议:使用 HTTPS、开启 OPcache、隔离运行用户、最小权限原则、定期备份与监控。