不能直接 apt install php，因为 ubuntu 20.04 官方源仅提供 php 7.4，而 laravel 11 要求 php ≥ 8.2；hetzner 镜像未预装 ondřej surý 的 ppa 源，必须手动添加 sury 源并安装 php8.2-cli、php8.2-fpm 等指定组件才能满足版本与扩展要求。
Laravel 11 要求 PHP ≥ 8.2，而 Hetzner 默认 Ubuntu 20.04 的系统源只提供 PHP 7.4 —— 直接 apt install php 会失败或装错版本，这是最常卡住的第一步。
为什么不能直接 apt install php
Ubuntu 20.04 官方仓库的 php 包是 7.4.x，但 Laravel 11 在安装时会检查 php -v，遇到低于 8.2 的版本会报错：Your PHP version (7.4.33) does not meet the minimum requirements for Laravel 11.。Hetzner 的镜像未预装 PPA，必须手动添加 Ondřej Surý 的 PHP 源才能获取 8.2+。
- 先运行
sudo apt update && sudo apt upgrade -y确保系统基础更新完成 - 安装必要工具：
sudo apt install -y software-properties-common ca-certificates curl gnupg - 导入 GPG 密钥：
curl -fsSL https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor -o /usr/share/keyrings/sury-keyring.gpg - 添加源：
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/sury-keyring.gpg] https://packages.sury.org/php/ focal main" | sudo tee /etc/apt/sources.list.d/php.list - 再执行一次
sudo apt update，此时apt list -a php应能显示php8.2和php8.3
安装 Laravel 11 所需的 PHP 扩展（缺一不可）
Laravel 11 默认启用 opcache、mbstring、xml、ctype、json、fileinfo、zip、curl、gd、bcmath，还新增了对 pgsql 或 mysql 驱动的强制要求（即使你用 SQLite，php-mysql 也得装，否则 composer create-project 会中止）。
- 一次性装全：
sudo apt install -y php8.2-cli php8.2-fpm php8.2-mysql php8.2-pgsql php8.2-sqlite3 php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-zip php8.2-opcache php8.2-readline php8.2-xmlrpc - 验证：
php -m | grep -E "(mbstring|xml|curl|bcmath|opcache)"应全部有输出 - 注意：不要装
libapache2-mod-php8.2—— Hetzner 多数用户用 Nginx + PHP-FPM，Apache 模块反而冲突
用 Composer 创建 Laravel 11 项目（绕过权限和路径陷阱）
Hetzner 的 VPS 默认用户不是 www-data，且 /var/www 权限通常为 root:root。如果直接 sudo composer create-project laravel/laravel .，会导致后续 php artisan 命令因文件属主问题报 Permission denied；若不用 sudo，又会因目录不可写失败。
- 推荐做法：在用户主目录初始化，避免权限纠缠：
cd ~ && mkdir myapp && cd myapp - 运行：
curl -s https://getcomposer.org/installer | php && php composer.phar create-project laravel/laravel . --stability=stable --prefer-dist - 完成后改属主：
sudo chown -R $USER:www-data ~/myapp，并设可写：chmod -R 775 ~/myapp/storage ~/myapp/bootstrap/cache - 关键点：
--stability=stable必须显式加，否则 Composer 可能拉到 dev 分支导致不兼容；Laravel 11 不再支持laravel new全局命令（已移除），只能用create-project
Nginx 配置要点（Laravel 11 的 public/index.php 路由行为变了）
Laravel 11 默认启用「自适应重写」机制，public/index.php 不再是唯一入口，而是通过 server.php 做 fallback。但 Hetzner 上 Nginx 若仍沿用旧版配置（如 try_files $uri $uri/ /index.php?$query_string），会导致 API 路由 404 或静态资源加载异常。
- 正确配置片段（放在
/etc/nginx/sites-available/myapp）：
location / {
try_files $uri $uri/ /server.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;（在 fastcgi-php.conf 中默认已有）sudo systemctl reload nginx && sudo systemctl restart php8.2-fpm
APP_URL 必须带协议和端口（如 https://example.com），否则生成的 URL 会漏掉 https，前端 Ajax 请求跨协议失败最后确认一点：Laravel 11 移除了 php artisan serve 的内置服务器支持（它现在只用于测试），生产环境必须走 Nginx/FPM —— 别指望用 php -S 临时跑起来看效果，那会直接 500。
