thinkphp在centos中的安装步骤

在 CentOS 中安装 ThinkPHP 的标准流程

如果你正准备在 CentOS 服务器上部署 ThinkPHP 应用，那么这份指南正适合你。以下步骤以 CentOS 7/8 和 ThinkPHP 8.0 为例，后者要求 PHP 版本不低于 8.0。当然，如果你使用的是 ThinkPHP 6.x 系列，环境要求通常是 PHP >= 7.1.0，其余的操作流程基本大同小异。

一 准备环境

万事开头难，部署的第一步就是搭建一个坚实可靠的环境。这就像盖房子前先打好地基，一步都不能马虎。

• 更新系统并安装必要工具
  • 首先，我们需要为系统添加必要的软件仓库。以 CentOS 7 为例，执行以下命令来安装 EPEL 和 Remi 仓库：
    • sudo yum install -y epel-release
    • sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
  • 接着，安装一些后续会用到的常用工具：
    • sudo yum install -y unzip git
• 安装 PHP 8.0 及常用扩展
  • ThinkPHP 8.0 需要 PHP 8.0 或更高版本。启用对应的仓库：
    • sudo yum-config-manager --enable remi-php80
  • 然后，一口气安装 PHP 核心及其常用的扩展，这些是框架运行的基础：
    • sudo yum install -y php php-cli php-fpm php-common php-mysqlnd php-gd php-mbstring php-zip php-curl php-xml php-bcmath php-json
  • 安装完成后，别忘了验证一下版本，确保一切就绪：
    • 输入 php -v，终端应该会显示类似 “PHP 8.0.x” 的信息。
• 安装 Composer
  • 作为 PHP 的依赖管理工具，Composer 必不可少。通过以下命令安装：
    • curl -sS https://getcomposer.org/installer | php
    • sudo mv composer.phar /usr/local/bin/composer
  • 同样，用 composer --version 检查是否安装成功。
• 可选优化
  • 为了大幅提升后续依赖包的下载速度，非常建议为 Composer 配置国内镜像：
    • composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

二 安装 ThinkPHP

环境搞定后，主角就可以登场了。安装 ThinkPHP 本身其实非常 straightforward。

• 使用 Composer 创建项目
  • 运行一条命令，Composer 就会帮你创建好一个全新的 ThinkPHP 应用。这里会在当前目录生成一个名为 “my-thinkphp-app” 的文件夹（你可以自定义这个名字）：
    • composer create-project topthink/think my-thinkphp-app
• 进入项目目录并启动内置开发服务器
  • 进入刚创建的项目目录：cd my-thinkphp-app
  • 然后启动 ThinkPHP 内置的简易开发服务器：php think run
• 访问测试
  • 打开浏览器，访问：http://<你的服务器公网IP>:8000
  • 如果能看到 ThinkPHP 的默认欢迎页面，那么恭喜你，开发环境下的安装已经成功了！

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

开发服务器只适合本地测试。要对外提供服务，我们还需要进行生产环境部署，并配置专业的 Web 服务器（Apache 或 Nginx）。

• 目录与权限
  • 关键一步：将你的 Web 服务器根目录指向项目下的 public 目录，这里是应用的入口。
  • 为了保证安全与正常运行，建议将项目目录的所有者设置为运行 PHP 进程的用户（比如 apache 或 nginx），并将目录权限设置为 755。当然，具体权限可以根据安全规范进行更严格的调整。
• Apache 配置要点
  • 确保 mod_rewrite 模块已启用，这是 ThinkPHP 路由功能所依赖的。
  • 虚拟主机配置示例：
    • DocumentRoot /var/www/my-thinkphp-app/public

    • 
          Options Indexes FollowSymLinks
          AllowOverride All
          Require all granted
      
      

• Nginx 配置要点
  • 核心思想是将所有非静态文件的请求都转发给 index.php 处理（使用 PATH_INFO 或兼容模式）。
  • 配置示例：

    • location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
      

    • location ~ \.php$ {
          fastcgi_pass 127.0.0.1:9000; # 或者 unix:/var/run/php-fpm/php-fpm.sock;
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
      

• 启动服务
  • 如果使用 Nginx，需要启动 PHP-FPM 和 Web 服务，并设置开机自启：
    • sudo systemctl start php-fpm
    • sudo systemctl enable php-fpm
    • sudo systemctl start nginx 或 sudo systemctl start httpd (Apache)
    • sudo systemctl enable nginx 或 sudo systemctl enable httpd
• 访问
  • 现在，你就可以通过浏览器访问 http://<你的域名或公网IP>/（注意，不再需要 :8000 端口了）来查看生产环境下的应用了。

四 常见问题与排查

即使按照步骤操作，偶尔也可能遇到一些小麻烦。这里列举几个常见问题及其解决方法，帮你快速排雷。

• 端口占用
  • 开发时如果默认的 8000 端口被占用，可以指定另一个端口启动：php think run -p 8080
  • 检查端口占用情况的命令：ss -tulnp | grep 8000（或者使用 netstat -tulnp | grep 8000）。
• 路由 404
  • 遇到页面 404，首先检查 Web 服务器的重写模块是否配置正确（Apache 的 AllowOverride All 或 Nginx 的 try_files 指令）。
  • 其次，再次确认 Web 根目录是否准确指向了项目的 public 目录。
• Composer 安装慢或失败
  • 这可能是网络问题。最有效的解决办法就是配置国内镜像源：
    • composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 类/函数未找到
  • 这类错误通常是因为缺少必要的 PHP 扩展。请确保已安装所有 ThinkPHP 可能需要的扩展，例如：php-mbstring, php-gd, php-curl, php-xml, php-bcmath, php-json。
• 权限问题
  • 确保运行 Web 服务的用户（如 www-data, nginx, apache）对项目的 runtime（运行时缓存）、vendor（依赖包）等目录有写入权限。在开发环境，可以简单设置为 755 或 775；但在生产环境，务必遵循最小权限原则进行更精细的设置。