部署laravel项目需先配置服务器环境,安装nginx、mysql、php及扩展,再克隆代码并安装依赖;接着配置.env文件为生产环境,设置应用密钥;然后配置Nginx站点指向public目录,设置权限与存储链接;执行数据库迁移与种子数据;配置Cron任务与队列监听;启用httpS加密;最后清除缓存以优化性能,确保安全与稳定运行。

Laravel 项目部署到线上服务器并不是简单地上传代码,而是一个涉及环境配置、安全设置和性能优化的完整流程。以下是将 Laravel 项目从本地部署到生产服务器的标准步骤,适用于大多数 linux 服务器(如 ubuntu + Nginx + MySQL + PHP 环境)。
1. 准备服务器环境
确保你的服务器具备运行 Laravel 所需的基础环境:
- 操作系统:推荐使用 Ubuntu 20.04/22.04 或 centos 7/8
- Web 服务器:Nginx 或 apache(推荐 Nginx)
- PHP 版本:Laravel 要求 PHP >= 8.1,建议安装 PHP 8.1 或更高版本
- 数据库:MySQL 或 mariadb
- 扩展支持:确保安装了必要的 PHP 扩展,如 openssl、pdo、mbstring、tokenizer、xml、curl、gd、zip 等
- 工具:composer、git
在 Ubuntu 上可使用以下命令快速安装:
sudo apt update sudo apt install nginx mysql-server php-fpm php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip git composer
2. 上传或克隆 Laravel 项目代码
将你的 Laravel 项目上传到服务器,通常放在 /var/www/your-project 目录下。
- 通过 Git 克隆(推荐):
cd /var/www git clone https://github.com/yourname/your-laravel-project.git your-project - 或使用 FTP/SFTP 上传压缩包后解压
进入项目目录并安装依赖:
cd /var/www/your-project composer install --optimize-autoloader --no-dev
–no-dev 参数会跳过开发依赖,提升生产环境安全性与性能。
3. 配置环境文件 .env
复制示例环境文件并根据服务器信息修改:
cp .env.example .env
编辑 .env 文件:
APP_ENV=production APP_DEBUG=false APP_URL=https://yourdomain.com <p>DB_HOST=localhost DB_DATABASE=your_db_name DB_USERNAME=your_db_user DB_PASSword=your_db_password
生成应用密钥:
php artisan key:generate
4. 配置 Web 服务器(以 Nginx 为例)
创建 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/your-project
写入以下内容(注意路径和域名):
server { listen 80; server_name yourdomain.com; root /var/www/your-project/public; <pre class="brush:php;toolbar:false;">index index.php index.html index.htm; 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 $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /.ht { deny all; }
}
启用站点:
sudo ln -s /etc/nginx/sites-available/your-project /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx
5. 设置权限和存储链接
Laravel 需要对某些目录有写权限:
sudo chown -R www-data:www-data /var/www/your-project sudo chmod -R 755 /var/www/your-project/storage sudo chmod -R 755 /var/www/your-project/bootstrap/cache
创建存储软链接(用于访问上传文件):
php artisan storage:link
6. 执行数据库迁移与种子(如有)
运行迁移:
php artisan migrate --force
如果需要填充测试数据:
php artisan db:seed --force
–force 是为了在生产环境中强制执行,避免交互确认。
7. 配置定时任务与队列(可选)
如果你使用了 Laravel 的任务调度功能,在服务器上添加 Cron 条目:
crontab -e
添加以下行:
* * * * * cd /var/www/your-project && php artisan schedule:run >> /dev/null 2>&1
对于队列监听(如使用 redis):
php artisan queue:work --daemon &
建议使用 Supervisor 管理队列进程。
8. 启用 HTTPS(强烈建议)
使用 Let’s Encrypt 免费证书:
sudo certbot --nginx -d yourdomain.com
之后会自动配置 SSL 并重定向 HTTP 到 HTTPS。
9. 清除缓存与优化(可选但推荐)
部署完成后运行以下命令提升性能:
php artisan config:cache php artisan route:cache php artisan view:cache
注意:只在生产环境执行这些命令,开发时应清除缓存调试。
基本上就这些。整个流程走完后,你的 Laravel 项目就已经成功部署上线。关键点在于环境一致性、安全配置和正确的文件权限管理。不复杂但容易忽略细节。
以上就是Laravel如何部署到服务器_线上部署Laravel项目的完整流程与步骤的详细内容,更多请关注php中文网其它相关文章!