在Linux服务器安装Laravel需先满足PHP 8.1+、Composer、基础扩展及数据库环境,再创建项目、配置权限与密钥,最后启动服务验证可用性。

在Linux服务器上安装Laravel框架,需先满足PHP 8.1+、Composer、基础扩展及数据库环境,再创建项目、配置权限与密钥,最后启动服务验证可用性。
检查并安装基础运行环境
执行php -v确认PHP版本不低于8.1;若未安装或版本过低,用apt install php8.1-cli php8.1-mbstring php8.1-xml php8.1-bcmath php8.1-sqlite3 php8.1-mysql php8.1-curl php8.1-opcache批量安装(Ubuntu/Debian系)。
运行php -m | grep -E 'mbstring|xml|curl|openssl|pdo'验证关键扩展已启用;缺失任一模块将导致artisan命令报错或路由无法解析。
执行curl -sS https://getcomposer.org/installer | php下载Composer安装脚本,再运行sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer使其全局可用。
创建Laravel项目
方法一:使用create-project(推荐用于生产环境)
执行composer create-project laravel/laravel myapp --prefer-dist --no-interaction。该命令跳过交互式提示,直接拉取最新稳定版骨架及依赖,避免因网络波动中断安装。
方法二:使用Laravel Installer(适合内网或快速初始化)
先运行composer global require laravel/installer,再确保~/.composer/vendor/bin已加入$PATH;之后执行laravel new myapp。此方式解压预构建包,不走完整composer install流程,速度更快但无法指定Laravel小版本。
【注意】两种方法生成的项目结构一致,但create-project会自动执行composer install并校验依赖完整性,laravel new则跳过vendor安装步骤——若后续执行php artisan tinker报Class not found,需手动进入目录补运行composer install。
Linux系统管理专家,覆盖12大模块:用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词:useradd、sudo、sshd_config、chmod、SEL...
配置项目权限与密钥
第一步:进入项目目录
cd myapp
第二步:赋予storage和bootstrap/cache写权限
chmod -R 755 storage bootstrap/cache。Laravel日志、缓存、session等全部写入storage,权限不足会导致500错误且无明确提示。
第三步:复制并生成环境密钥
cp .env.example .env → php artisan key:generate。这一步必须执行,否则APP_KEY为空将使所有加密操作(如session、cookie签名)失效,登录态无法维持。
第四步:设置Web服务器根目录指向public
Nginx需在server块中配置root /var/www/myapp/public;,Apache需启用mod_rewrite并确保AllowOverride All生效。不指向public目录会导致index.php暴露或路由404。
启动开发服务验证安装
执行php artisan serve --host=0.0.0.0 --port=8000。默认只监听127.0.0.1,加--host=0.0.0.0才能从局域网其他机器访问。
打开浏览器访问http://服务器IP:8000,看到Laravel欢迎页面即表示安装完成。

















