必须跳过 Composer 自动依赖解析,直接用官方源码包部署 Laravel 项目;下载 GitHub Releases 的 laravel-v11.x.x.zip(非 Source code),解压后补全 vendor 目录(复制或离线 install),重命名 .env.example,运行 php artisan key:generate,设置 storage 和 bootstrap/cache 写权限,最后 php artisan serve 验证。

你需要跳过 Composer 自动依赖解析,直接用官方源码包部署 Laravel 项目,比如内网环境无法联网、CI/CD 流水线禁止运行 composer install、或需严格控制文件哈希一致性时必须这么做。
下载并解压官方源码包
访问 Laravel GitHub Releases 页面,找到最新稳定版(如 v11.22.0),点击 Assets 展开,下载 laravel-v11.22.0.zip 文件(不是 Source code zip)。
将 ZIP 解压到目标目录,例如 D:\myapp 或 /var/www/myapp;解压后目录内必须包含 artisan、composer.json、public/ 等标准结构。
补全 vendor 目录与核心依赖
源码包不含 vendor/,必须手动填充。你有两个选择:
方法一:用已有的 vendor 备份复制(最快)
在另一台已成功运行 composer install 的同版本 Laravel 项目中,打包整个 vendor/ 目录,直接覆盖到当前项目的 vendor/ 下;【必须确保 PHP 版本、扩展、Composer 平台配置完全一致,否则运行时会报 Class not found】。
方法二:离线安装依赖(需提前准备)
在可联网机器上,进入该源码包根目录,执行:composer install --no-dev --optimize-autoloader --ignore-platform-reqs;完成后打包 vendor/ 和生成的 autoload.php,再拷贝过来。
初始化环境与密钥
第一步:复制环境配置文件
将 .env.example 重命名为 .env。
第二步:生成应用密钥
在项目根目录下运行:php artisan key:generate;这一步不可跳过,否则会提示 Application key not set 并拒绝启动。
第三步:设置 storage 和 bootstrap/cache 写权限
Linux/macOS 执行:chmod -R 755 storage bootstrap/cache;Windows 用户右键文件夹 → 属性 → 安全 → 编辑 → 给当前用户勾选“写入”权限。
第四步:确认 APP_KEY 已写入 .env 文件,且值为 32 位随机字符串,形如 base64:qJf9aX...。
验证服务能否启动
执行 php artisan serve --host=127.0.0.1 --port=8000;若终端输出 Laravel development server started,并在浏览器打开 http://127.0.0.1:8000 能看到 Laravel 欢迎页,说明手动安装完成。


















