在 coolify 中使用 nixpacks 部署 laravel 项目，需要在 coolify 面板的项目设置中将 build_provider 设置为 nixpacks。这样做会让 coolify 调用 nixpacks 构建器来生成 docker 镜像，而不是使用默认的 dockerfile 或 herokuish。nixpacks 会自动检测 laravel 项目结构，安装 composer 依赖并编译前端资源。
Nixpacks 如何自动识别 Laravel 构建步骤？
Nixpacks 通过读取项目根目录下的 nixpacks.toml 配置文件（如果存在）或应用其内置的默认规则来确定构建流程。对于 Laravel 项目，它默认会执行 composer install 来安装 PHP 依赖，然后运行 npm ci 和 npm run build 来处理前端资产。如果项目中有自定义的构建需求，可以通过在项目根目录添加 nixpacks.toml 文件来自定义这些步骤。
[phases.setup]
nixpkgs-archive = "nixpkgs-unstable"
[phases.install]
# 安装系统级依赖
cmds = [
"apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev zip unzip git curl",
"docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd"
]
[phases.composer]
# 安装 PHP 依赖
cmds = ["composer install --no-dev --optimize-autoloader"]
[phases.npm]
# 安装 Node.js 依赖并构建前端
cmds = ["npm ci", "npm run build"]
[phases.production]
# 启动命令
cmds = ["php-fpm"]
[nixpacks.php]
version = "8.2"
[nixpacks.node]
version = "18"
上述 nixpacks.toml 配置展示了 Nixpacks 处理 Laravel 项目的典型流程。首先，setup 阶段初始化 Nix 环境。install 阶段安装必要的系统库和 PHP 扩展，这是 Laravel 运行所必需的。composer 阶段负责安装 PHP 包，npm 阶段处理前端构建。最后，production 阶段指定容器启动时运行的命令，对于 Laravel 通常是 php-fpm。这种分阶段的构建方式确保了环境的可重复性和一致性。
如何处理 Laravel 的环境变量和存储权限？
Laravel 项目在 Nixpacks 构建后，需要正确配置环境变量和存储目录权限才能正常运行。在 Coolify 中，你可以在项目设置的 Environment Variables 部分添加所有必要的 .env 变量，如数据库连接信息、APP_KEY 等。Nixpacks 构建的镜像会将这些变量注入到容器中。此外，Laravel 的 storage 和 bootstrap/cache 目录需要正确的写入权限。在 Nixpacks 构建的镜像中，通常需要将 Web 服务器用户（如 www-data）设为这些目录的所有者，或者确保运行进程有写入权限。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
# 在 nixpacks.toml 的 production 阶段之前添加权限设置
[phases.permissions]
cmds = [
"chown -R www-data:www-data /app/storage",
"chown -R www-data:www-data /app/bootstrap/cache",
"chmod -R 775 /app/storage",
"chmod -R 775 /app/bootstrap/cache"
]
[phases.production]
cmds = ["php-fpm"]
在 nixpacks.toml 中添加 permissions 阶段，确保在启动 php-fpm 之前，Laravel 所需的存储和缓存目录具有正确的权限。这可以避免运行时出现权限错误。同时，确保在 Coolify 中正确设置了 APP_KEY，可以通过运行 php artisan key:generate 生成，并将其作为环境变量传入容器。这样，Laravel 应用就能在 Nixpacks 构建的镜像中稳定运行。
Nixpacks 构建的 Laravel 镜像体积如何优化？
Nixpacks 构建的 Laravel 镜像可能包含不必要的开发依赖和工具，导致镜像体积较大。为了优化镜像体积，可以在 nixpacks.toml 中精确控制安装的包和版本，避免安装全局不需要的工具。例如，只安装生产环境所需的 PHP 扩展和 Node.js 模块。此外，可以使用多阶段构建的思想，虽然 Nixpacks 本身不支持标准的 Docker 多阶段构建，但可以通过在 nixpacks.toml 中清理临时文件和缓存来减小最终镜像的大小。例如，在 composer 和 npm 阶段后添加清理命令。
[phases.composer] cmds = ["composer install --no-dev --optimize-autoloader", "rm -rf ~/.composer/cache"] [phases.npm] cmds = ["npm ci --production=false", "npm run build", "rm -rf node_modules/.cache"]
通过在 composer 和 npm 阶段后添加清理命令，可以移除不必要的缓存和临时文件，从而减小最终镜像的大小。同时，确保在 composer install 时使用 --no-dev 标志，只安装生产环境依赖。这些优化措施有助于提高部署效率和减少资源消耗。
