laravel 10 在 clear linux 上部署需确保三点：php 8.1+ 且 mbstring、openssl、pdo 等扩展真实启用；nginx root 必须指向 public 目录并正确配置 try_files 与 $realpath_root；.env 必在项目根目录，storage 和 bootstrap/cache 权限属 nginx 用户。
Clear Linux 上跑 Laravel 10 不是“装完就能用”，核心卡点在 PHP 扩展加载路径、Nginx root 指向、以及 .env 必须在项目根目录——这三点错一个，500 或 403 就直接甩脸上。
确认 PHP 8.1+ 且所有扩展真实启用
Clear Linux 的 php bundle 默认提供的是 PHP 8.2（2026 年 9 月稳定版），但扩展不自动加载。只跑 php -v 看版本没用，php -m 才是真相：
-
php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json|intl)"—— 每项都必须有输出；缺intl会导致Carbon初始化失败，页面白屏 - Clear Linux 的扩展配置文件在
/usr/share/defaults/etc/php.d/下，不是传统php.ini；检查对应.ini文件是否已启用，比如30-mbstring.ini里要有extension=mbstring - 若某扩展缺失（如
intl），执行sudo swupd bundle-add php-intl；别信 “bundle 已安装”，得验证模块真被 PHP 加载
Nginx 配置必须绕过 public/ 入口陷阱
Clear Linux 的 nginx bundle 默认不启动，且默认配置不兼容 Laravel。常见错误是把 root 指向项目根目录（如 /var/www/myapp），结果所有请求返回 403 Forbidden 或直接下载 index.php 源码。
- 站点配置路径为
/etc/nginx/conf.d/myapp.conf，root必须设为/var/www/myapp/public，不是项目根目录 -
location /块内必须包含：try_files $uri $uri/ /index.php?$query_string;；漏掉就路由全 404 -
location ~ \.php$块中，fastcgi_param SCRIPT_FILENAME必须用$realpath_root$fastcgi_script_name，不能只写$document_root$fastcgi_script_name，否则$_SERVER['SCRIPT_FILENAME']错位，Laravel 路由服务注册失败 - 验证语法：
sudo nginx -t，再sudo systemctl reload nginx
composer install 必须加 --optimize-autoloader 且清缓存
Clear Linux 的默认 swupd 环境下，composer 是通过 php-composer bundle 提供的，但内存限制极严。不加优化参数，composer install 极易 OOM 或卡死在 Downloading packages。
- 先确保
.env已复制并填好数据库等信息：cp .env.example .env - 生成密钥：
php artisan key:generate - 执行安装：
COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader - 若仍卡住，删 Composer 缓存：
rm -rf ~/.composer/cache，再重试；别依赖旧缓存，Clear Linux 的 DNS 解析策略有时会让镜像源响应异常
APP_URL 和 storage 权限必须与 nginx 用户一致
Clear Linux 默认用 nginx 用户跑服务（非 www-data 或 apache），而 storage 和 bootstrap/cache 目录权限若不匹配，500 错误不会报具体原因，只会静默失败。
-
APP_URL必须与实际访问域名完全一致（开发用http://localhost，别写127.0.0.1）；Chrome 对localhost和 IP 处理不同，影响 CSRF token - 执行：
sudo chown -R nginx:nginx /var/www/myapp/storage /var/www/myapp/bootstrap/cache - 执行：
sudo chmod -R 775 /var/www/myapp/storage /var/www/myapp/bootstrap/cache - 别漏掉
bootstrap/cache/packages.php和services.php，它们是config:cache生成的，权限不对就无法读取
Clear Linux 的硬实时特性让 PHP-FPM 启动更快，但也意味着路径和权限检查更严格；最容易被忽略的是 fastcgi_param SCRIPT_FILENAME 没用 $realpath_root，导致整个 RouteServiceProvider 加载失败，页面空白却无日志可查。
