pixelbrackets/pap-skeleton

PHP 应用发布 - 骨架项目

2.0.0 2021-11-22 09:21 UTC

This package is auto-updated.

Last update: 2024-09-24 18:48:39 UTC


README

本指南解释了如何构建和部署应用。

工具链通过 PAP 设置。

需求

  • cURL、SSH 和 rsync 以同步文件
  • Git 以检出包仓库
  • PHP 以运行脚本
  • Composer 以获取所需的 PHP 包
  • 在目标阶段(s)上的 SSH 账户,具有读写访问权限,并有权运行 cURL、rsync 和 PHP
apt-get install curl ssh rsync git php
wget https://getcomposer.org.cn/composer.phar

安装

  • 运行 ./composer.phar install 获取所需的 PHP 包

使用

  • 运行 ./vendor/bin/pap 查看所有可用任务
  • 在每个任务命令后添加 --help,查看所有可用选项
  • 在每个任务命令后添加 --simulate,首先以模拟模式运行
  • 大多数任务有一个阶段作为目标,通过 --stage <stagename> 传递
  • 如果没有传递阶段名称,则默认使用名称 "local" - 用于在本地机器上开发
  1. 部署到 "live" 阶段

    ./vendor/bin/pap deploy --stage live
  2. 部署到 "local" 阶段,用于开发(默认阶段)

    ./vendor/bin/pap deploy
  3. 同步到 "local" 阶段(跳过构建资源文件)

    ./vendor/bin/pap sync
  4. 如果源目录中发生任何更改(文件已更改、添加或删除),则自动同步到 "local" 阶段

    ./vendor/bin/pap watch
  5. 检查当前构建

    ./vendor/bin/pap lint

配置

  • 所有通用设置和共享阶段都在分发文件 pap.yml 中配置
  • 所有设置和阶段都可以在本地环境文件 pap.local.yml 中重写,该文件会被 Git 忽略
    • 复制 pap.local.template.yml,将其重命名为 pap.local.yml,并按需更改参数
  • 所有选项的文档在 PAP 包仓库中可用

更新

  • 运行 ./composer.phar update 更新所需的 PHP 包
  • 提交更新的 composer.lock 文件

升级

  • 检查 PAP 包仓库的新版本和升级指南