CentOS ThinkPHP如何安装配置

CentOS系统安装配置ThinkPHP详细步骤

一、环境准备：安装基础软件包

在CentOS上部署ThinkPHP前，需先安装Web服务器（Nginx/Apache）、PHP环境及Composer（ThinkPHP的依赖管理工具）。

• 更新系统包：

  sudo yum update -y
  

• 安装Nginx（以Nginx为例，Apache步骤类似）：

  sudo yum install epel-release -y
  sudo yum install nginx -y
  sudo systemctl start nginx
  sudo systemctl enable nginx
  

• 安装PHP及扩展（ThinkPHP 6.x需PHP 7.2+）：

  sudo yum install php php-fpm php-mysqlnd php-gd php-mbstring php-curl php-xml php-bcmath -y
  sudo systemctl start php-fpm
  sudo systemctl enable php-fpm
  

• 验证PHP版本：

  php -v
  

  确保PHP版本符合ThinkPHP要求（如ThinkPHP 6.x需≥7.2）。

二、安装Composer（ThinkPHP依赖管理工具）

ThinkPHP项目依赖Composer管理，需先全局安装Composer：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

验证安装：

composer --version

显示Composer版本号则表示安装成功。

三、部署ThinkPHP项目

1. 创建项目目录

选择项目存放路径（如/var/www/html/thinkphp），并赋予适当权限：

sudo mkdir -p /var/www/html/thinkphp
sudo chown -R nginx:nginx /var/www/html/thinkphp  # 若使用Nginx，用户为nginx
sudo chmod -R 755 /var/www/html/thinkphp

2. 使用Composer创建ThinkPHP项目

进入项目目录，通过Composer创建ThinkPHP项目（以ThinkPHP 6.x为例）：

cd /var/www/html/thinkphp
composer create-project topthink/think tp6 --prefer-dist

等待Composer下载并安装依赖（约几分钟）。

四、配置Web服务器（Nginx为例）

ThinkPHP需通过Web服务器访问，需配置Nginx的重写规则以支持PATHINFO（路由功能）。

• 创建Nginx配置文件：

  sudo vim /etc/nginx/conf.d/thinkphp.conf
  

• 添加以下配置（替换your_domain.com为域名/IP，/var/www/html/thinkphp/tp6/public为项目public目录路径）：

  server {
      
      listen 80;
      
      server_name your_domain.com;
      
      root /var/www/html/thinkphp/tp6/public;
      
      index index.php index.html index.htm;
  
  
      location / {
      
          try_files $uri $uri/ /index.php?$query_string;
  
      }
  
  
      location ~ \.php$ {
      
          fastcgi_pass unix:/run/php-fpm/www.sock;
      
          fastcgi_index index.php;
      
          include fastcgi_params;
      
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      
          fastcgi_param PATH_INFO $fastcgi_path_info;
  
      }
  
  
      location ~ /\.ht {
      
          deny all;
  
      }
  
  }
      
  

• 测试Nginx配置：

  sudo nginx -t
  

  若显示syntax is ok，则重启Nginx：

  sudo systemctl restart nginx
  

Apache配置（可选）

若使用Apache，需启用mod_rewrite模块并创建虚拟主机：

sudo a2enmod rewrite
sudo systemctl restart apache2

虚拟主机配置参考Nginx的try_files规则，确保支持PATHINFO。

五、配置数据库连接

ThinkPHP项目需连接数据库（如MySQL），修改项目配置文件：

• 进入项目目录：

  cd /var/www/html/thinkphp/tp6
  

• 复制.env.example为.env（隐藏配置文件）：

  cp .env.example .env
  

• 编辑.env文件，修改数据库连接信息（替换为实际值）：

  DB_TYPE=mysql
  DB_HOST=127.0.0.1
  DB_NAME=your_database_name
  DB_USER=your_database_user
  DB_PASSWORD=your_database_password
  DB_PORT=3306
  DB_PREFIX=tp_
  

创建数据库

登录MySQL，创建数据库和用户：

mysql -u root -p

CREATE DATABASE your_database_name;
    
CREATE USER 'your_database_user'@'localhost' IDENTIFIED BY 'your_database_password';
    
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_database_user'@'localhost';
    
FLUSH PRIVILEGES;
    
EXIT;
    

六、设置目录权限

确保项目目录权限正确，避免访问错误：

sudo chown -R nginx:nginx /var/www/html/thinkphp/tp6  # Nginx用户
sudo chmod -R 755 /var/www/html/thinkphp/tp6
sudo chmod -R 775 /var/www/html/thinkphp/tp6/runtime  # runtime目录需可写

七、启动项目并访问

• 启动PHP-FPM（若未启动）：

  sudo systemctl start php-fpm
  sudo systemctl enable php-fpm
  

• 访问项目：
  在浏览器输入http://your_domain.com（或服务器IP），若看到ThinkPHP欢迎页面，则部署成功。

常见问题排查

• 502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php-fpm），确认Nginx配置中的fastcgi_pass路径正确（如unix:/run/php-fpm/www.sock）。
• 路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string; ，支持PATHINFO。
• Composer安装慢：使用国内镜像加速（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。

通过以上步骤，即可在CentOS系统上成功安装配置ThinkPHP项目。

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