centos下thinkphp框架安装步骤

CentOS 下 ThinkPHP 安装步骤

一 准备环境

• 操作系统建议：CentOS 7.x（亦可参考 Alibaba Cloud Linux 3/2 或 CentOS 7.2 的同类步骤）。
• 安全组与防火墙：放行入方向端口 22、8000、443（云服务器安全组与系统防火墙均需放行，便于后续访问与部署）。
• 基础工具：更新系统并安装常用工具（可选）sudo yum update -y && sudo yum install -y unzip git wget。

二 安装 PHP 与常用扩展

• 安装 EPEL 与 Remi 仓库（以 CentOS 7.x 为例）：
  • sudo yum install -y epel-release
  • sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
• 启用 PHP 8.0 仓库并安装（ThinkPHP 8.x 要求 PHP >= 8.0）：
  • sudo yum -y install yum-utils
  • sudo yum-config-manager --enable remi-php80
  • sudo yum install -y php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-curl php-xml php-bcmath php-json
• 验证版本：php -v，应显示如 PHP 8.0.x。

三 安装 Composer

• 安装依赖：sudo yum install -y unzip git
• 下载并全局安装 Composer：
  • curl -sS https://getcomposer.org/installer | php
  • sudo mv composer.phar /usr/local/bin/composer
• 验证版本：composer --version（如 Composer 2.x）。
• 国内镜像（可选，提升下载速度）：`composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/**。

四 创建并启动 ThinkPHP 项目

• 创建项目（当前目录将生成名为 my-thinkphp-app 的应用）：
  • composer create-project topthink my-thinkphp-app
• 进入项目目录并启动内置开发服务器：
  • cd my-thinkphp-app
  • php think run
• 访问测试：在浏览器打开 http://<服务器公网IP>:8000，出现 ThinkPHP 欢迎页即表示安装成功。

五 生产环境部署与常见问题

• Web 服务器配置要点
  • Apache：启用 mod_rewrite，在虚拟主机或 .htaccess 中使用规则：

    <IfModule mod_rewrite.c>
        Options +FollowSymlinks -Indexes
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
    </IfModule>
    

  • Nginx：将请求转发至 index.php（PATH_INFO 方式）：

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=/$1 last;
            break;
        }
    }
    

  • 建议将站点根目录指向项目的 public 目录，仅暴露入口文件，提升安全性。
• 目录权限与运行用户
  • 确保 runtime、public/uploads 等目录可写（如 chmod -R 755 runtime public/uploads，运行用户与 Web 服务一致）。
• 常见问题排查
  • 端口占用：开发时可用 php think run -p 8080 更换端口；生产环境请使用 80/443 并由 Nginx/Apache 反向代理。
  • 路由 404：检查 Web 服务器重写规则是否正确启用，且项目入口为 public/index.php。
  • Composer 安装慢或失败：切换国内镜像源并重试；必要时执行 composer clear-cache。
  • PHP 版本不符：ThinkPHP 8.x 需 PHP >= 8.0，可通过 yum-config-manager --enable remi-php80 切换版本。