centos与thinkphp集成开发指南

CentOS 与 ThinkPHP 集成开发指南

一 环境准备与版本选择

• 操作系统建议：CentOS 7.x（亦可参考 Alibaba Cloud Linux 3/2 的步骤）。
• PHP 版本要求：
  • ThinkPHP 6.x：PHP ≥ 7.1.0
  • ThinkPHP 8.x：PHP ≥ 8.0.0
• 数据库与缓存：常用 MySQL/MariaDB，缓存可选 Redis。
• 开发工具：Composer（PHP 依赖管理）、Git（拉取代码）。
• 说明：ThinkPHP 在 Linux 上可稳定运行，常见搭配为 Nginx/Apache + PHP-FPM 或 Apache 模块方式。

二 安装与初始化

• 安装 EPEL 与 Remi 仓库（CentOS 7）：
  • sudo yum install -y epel-release
  • sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
• 启用 PHP 8.0 仓库并安装 PHP 及常用扩展（示例为 8.0，满足 TP 8 要求）：
  • sudo yum-config-manager --enable remi-php80
  • sudo yum install -y php php-cli php-fpm php-mysqlnd php-zip php-devel php-gd php-mcrypt php-mbstring php-curl php-xml php-pear php-bcmath php-json
  • php -v（确认版本，如：PHP 8.0.x）
• 安装 Composer：
  • sudo yum install -y unzip git
  • curl -sS https://getcomposer.org/installer | php
  • sudo mv composer.phar /usr/local/bin/composer
  • composer --version
• 创建 ThinkPHP 项目（以 8.x 为例）：
  • composer create-project topthink my-tp-app
  • cd my-tp-app & & php think run（开发服务器默认监听 8000 端口）
  • 浏览器访问：http://< 服务器公网IP> :8000 验证安装成功。

三 生产环境部署与 Web 服务器配置

• 目录与入口规范：对外仅暴露 public/ 目录，Web 根指向 public；项目代码与 runtime/ 置于 Web 根之外。
• Apache 配置要点（确保启用 mod_rewrite）：
  • 启用重写：sudo a2enmod rewrite & & sudo systemctl restart httpd
  • 虚拟主机示例（将 DocumentRoot 指向 public，并启用 .htaccess 重写）：
    • DocumentRoot /var/www/html/my-tp-app/public
    • < Directory /var/www/html/my-tp-app/public>
      • AllowOverride All
      • Require all granted
• Nginx 配置要点（PHP-FPM，FastCGI）：
  • 建议将站点根目录指向 public，并配置 try_files 与 fastcgi_pass 127.0.0.1:9000
  • 示例片段：
    • root /var/www/html/my-tp-app/public;
    • index index.php index.html;
    • location / {
      • try_files $uri $uri/ /index.php?$query_string;
      • }
    • location ~ .php$ {
      • fastcgi_pass 127.0.0.1:9000;
      • fastcgi_index index.php;
      • fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      • include fastcgi_params;
      • }
• 权限与运行用户（示例以 nginx:nginx 为例，Apache 可用 apache:apache）：
  • sudo chown -R nginx:nginx /var/www/html/my-tp-app
  • sudo find /var/www/html/my-tp-app -type d -exec chmod 755 { } ;
  • sudo find /var/www/html/my-tp-app -type f -exec chmod 644 { } ;
  • 确保 runtime/ 可写：sudo chmod -R 775 /var/www/html/my-tp-app/runtime
• 服务启动与自启：
  • sudo systemctl enable --now php-fpm
  • sudo systemctl enable --now nginx（或 httpd）

四 数据库与连接配置

• 安装与初始化数据库（MariaDB 示例）：
  • sudo yum install -y mariadb-server mariadb
  • sudo systemctl enable --now mariadb
  • sudo mysql_secure_installation（设置 root 密码与基础安全项）
• 创建应用数据库与用户（示例）：
  • CREATE DATABASE tp_app DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • CREATE USER ‘tp_user’@‘127.0.0.1’ IDENTIFIED BY ‘StrongPass!’;
  • GRANT ALL PRIVILEGES ON tp_app.* TO ‘tp_user’@‘127.0.0.1’;
  • FLUSH PRIVILEGES;
• ThinkPHP 配置：
  • 在 .env 或 config/database.php 中设置：
    • TYPE=mysql
    • HOSTNAME=127.0.0.1
    • DATABASE=tp_app
    • USERNAME=tp_user
    • PASSWORD=StrongPass!
    • HOSTPORT=3306
    • CHARSET=utf8mb4
  • 开发环境可开启 APP_DEBUG=true；生产环境务必关闭并配置合适的缓存与日志策略。

五 常见问题与排查

• 端口与防火墙：
  • 开发时内置服务器默认 8000；生产环境建议使用 80/443。
  • 放行安全组与防火墙：sudo firewall-cmd --permanent --add-port=80/tcp --add-port=443/tcp & & sudo firewall-cmd --reload
• 路由 404 或白屏：
  • 确认 Web 服务器根目录指向 public/，并启用 URL 重写（Apache 的 mod_rewrite 或 Nginx 的 try_files）。
• 权限错误：
  • 确保 runtime/ 与日志目录可写；Web 服务运行用户对项目目录具备读写权限。
• PHP 版本不匹配：
  • 使用 php -v 确认版本；TP 8 需 PHP ≥ 8.0，TP 6 需 PHP ≥ 7.1。
• Composer 安装缓慢或失败：
  • 可临时使用国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！