Linux服务器上Laravel项目部署步骤

以下是在Linux服务器上部署Laravel项目的核心步骤：

一、环境准备

1. 更新系统

   sudo apt update && sudo apt upgrade -y  
   

2. 安装必要软件
   • PHP（需7.3+版本）：

     sudo apt install php php-fpm php-mysql php-curl php-mbstring php-xml php-zip  
     

   • Composer（PHP依赖管理工具）：

     curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer  
     

   • Web服务器（以Nginx为例）：

     sudo apt install nginx  
     

   • 数据库（如MySQL）：

     sudo apt install mysql-server  
     sudo mysql_secure_installation  
     

二、部署Laravel项目

1. 上传项目
   • 通过FTP/SCP将项目文件上传至服务器，建议放在/var/www/目录下，确保public目录为Web根目录。
2. 配置环境变量
   • 复制.env.example为.env，修改数据库连接、APP_KEY等信息：

     cp .env.example .env  
     nano .env  
     

     DB_CONNECTION=mysql  
     DB_HOST=127.0.0.1  
     DB_PORT=3306  
     DB_DATABASE=laravel_db  
     DB_USERNAME=root  
     DB_PASSWORD=your_password  
     APP_ENV=production  
     APP_DEBUG=false  
     

3. 生成应用密钥

   php artisan key:generate  
   

4. 安装依赖并优化

   composer install --no-dev --optimize-autoloader  
   php artisan config:cache  
   php artisan route:cache  
   

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

1. 编辑Nginx配置文件

   sudo nano /etc/nginx/sites-available/laravel  
   

   添加以下内容（替换路径和域名）：

   server {  
       listen 80;  
       server_name your_domain.com;  
       root /var/www/laravel/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:/var/run/php/php8.1-fpm.sock;  
           fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;  
       }  
       location ~ /\.(?!well-known).* {  
           deny all;  
       }  
   }  
   

   • 启用配置并重启Nginx：

     sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/  
     sudo nginx -t  
     sudo systemctl restart nginx  
     

四、设置权限与安全

1. 配置文件权限

   sudo chown -R www-data:www-data /var/www/laravel  
   sudo chmod -R 755 /var/www/laravel  
   sudo chmod -R 775 /var/www/laravel/storage /var/www/laravel/bootstrap/cache  
   

2. 配置防火墙（可选）

   sudo ufw allow 'Nginx Full'  
   

五、验证部署

• 访问http://your_domain.com，若显示Laravel欢迎页面，则部署成功。
• 若使用队列，需启动队列监听器：

  nohup php artisan queue:work --sleep=3 --tries=3 &  
  

注意事项：

• 生产环境需关闭APP_DEBUG，并定期备份数据库。
• 若使用HTTPS，可通过Certbot配置SSL证书。
• 确保服务器PHP版本与Laravel项目要求的版本一致。

参考来源：