Linux下ThinkPHP部署步骤

在Linux环境下部署ThinkPHP应用，其实并没有想象中那么复杂。只要把整个流程拆解开，按步骤来，基本不会出什么大问题。下面这份部署指南，涵盖了从环境搭建到安全优化的完整路径，跟着走就好。

1. 准备基础环境

先把基础环境搭起来，需要准备的东西有：PHP、Web服务器（Nginx或Apache）、Composer，以及数据库（MySQL或PostgreSQL）。

• 安装PHP：建议选择7.4及以上版本，并且要确保PDO、OpenSSL、Mbstring、XML、Curl这些扩展都是开启的。以Ubuntu为例，一条命令就能搞定：sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl。如果是CentOS系统，把包名稍作调整：sudo yum install php php-fpm php-mysqlnd php-mbstring php-xml php-curl。
• 安装Web服务器：Nginx在高并发场景下表现更好，Apache则胜在配置直观，适合传统应用。这里以Ubuntu安装Nginx为例，执行sudo apt install nginx即可。
• 安装Composer：PHP依赖管理利器。执行curl -sS https://getcomposer.org/installer | php，然后把生成的composer.phar移到/usr/local/bin/composer，全局调用更方便。
• 安装数据库：以MySQL为例，sudo apt install mysql-server，初始化后记得设置root密码。

2. 上传并放置项目代码

项目文件推荐放在/var/www/html/your_project这个路径下（把your_project换成你的实际项目名就行）。上传方式有两种比较常用：

• SCP/FTP：用scp命令直接传，比如scp -r local_project.zip user@server_ip:/var/www/html/。或者用FileZilla这类图形化工具，拖拉上传就行。
• Git克隆：如果项目托管在Git仓库，直接在服务器上执行git clone repository_url /var/www/html/your_project，省去上传的麻烦。

上传完成后，如果是压缩包，记得先解压，然后进入项目目录。

3. 安装项目依赖

进入项目根目录，执行composer install。这一步会自动拉取composer.json里定义的所有依赖包，包括ThinkPHP核心组件和数据库驱动等。安装完成后，项目目录下会生成一个vendor文件夹，这就是所有依赖的存放位置。

4. 配置Web服务器

这一步是部署的核心，配置对了一次成功，配置错了可能折腾半天。

Nginx配置（推荐）

• 先创建站点配置文件：sudo nano /etc/nginx/sites-a vailable/your_project，然后把下面这段配置贴进去（记得替换your_domain和项目路径）：

server {
    listen 80;
    server_name your_domain.com;
    root /var/www/html/your_project/public;
    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

• 启用站点：sudo ln -s /etc/nginx/sites-a vailable/your_project /etc/nginx/sites-enabled/
• 测试配置并重启：先执行sudo nginx -t检查语法有没有问题，没问题再用sudo systemctl restart nginx重启服务。

Apache配置（可选）

• 先启用mod_rewrite模块：sudo a2enmod rewrite
• 修改站点配置，比如/etc/apache2/sites-a vailable/000-default.conf，把DocumentRoot指向项目的public目录，并添加AllowOverride All，这样才能支持.htaccess的重写规则。
• 最后重启Apache：sudo systemctl restart apache2

5. 配置数据库连接

编辑项目根目录下的.env文件（如果没有，就把config/.env.example复制一份）。修改数据库连接信息，格式如下：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password

然后创建对应的数据库：mysql -u root -p -e "CREATE DATABASE your_database_name;"。如果手头有SQL文件，顺手把表结构也导入进去。

6. 设置目录权限

这一步很容易被忽略，但很重要。Web服务器用户（通常是www-data）需要有读写权限：

sudo chown -R www-data:www-data /var/www/html/your_project
sudo chmod -R 755 /var/www/html/your_project
sudo chmod -R 775 /var/www/html/your_project/runtime  # runtime目录必须可写

需要提醒的是，千万别图省事直接用777权限，安全风险很大。

7. 启动服务并测试访问

• 启动Web服务器：Nginx用sudo systemctl start nginx，Apache用sudo systemctl start apache2。
• 然后在浏览器输入http://your_domain.com（或者服务器IP地址），如果看到ThinkPHP的欢迎页面，说明部署成功了。这一刻的感觉还是挺不错的。

8. 安全与优化（可选但推荐）

部署上线之后，有几个优化点值得花点时间处理：

• 关闭调试模式：打开config/app.php，把app_debug设为false。生产环境开着调试模式，等于把家底都亮给别人看。
• 启用HTTPS：用Let’s Encrypt免费证书，执行sudo apt install certbot python3-certbot-nginx（以Nginx为例），然后sudo certbot --nginx -d your_domain.com，跟着提示走完就行。
• 开启OPcache：修改php.ini，把opcache.enable=1打开。这个优化对PHP执行效率的提升非常明显。