pickles2/app-burdock

在PHP服务器和浏览器上运行的Pickles 2的GUI工具。是针对Pickles Framework 2的CMS样式的文本编辑器"Pickles 2"的网页版。


README

在PHP服务器和浏览器上运行的Pickles 2的GUI工具。

是针对Pickles Framework 2的CMS样式的文本编辑器"Pickles 2"的网页版。

安装

1. 安装app-burdock的依赖库

git clone https://github.com/pickles2/app-burdock.git;
cd app-burdock;
composer install;
npm install;

2. 创建并设置.env文件

.env.example复制并重命名为.env作为样本配置文件。

cp .env.example .env;

请根据需要更新此设置文件中的相关设置。

vi .env;

应用程序基本信息设置

根据需要更改设置。

APP_NAME=Burdock
APP_ENV=local
APP_KEY=base64:NOwK3+2AQLj41zWorz0d1JXe7cKSGRTKMtJs9tSm4/g=
APP_DEBUG=true

使用以下命令重新生成应用程序密钥。

$ php artisan key:generate;
Application key set successfully.

设置应用程序服务器和预览服务器的URL

请为应用程序服务器和预览服务器设置不同的URL。

APP_URL=https://example.com
BD_PREVIEW_DOMAIN=preview.example.com
BD_STAGING_DOMAIN=staging.example.com

数据库连接设置

更新数据库连接信息。以下示例为使用SQLite的设置。

DB_CONNECTION=sqlite
DB_HOST=
DB_PORT=
DB_DATABASE=../bd_data/database.sqlite
DB_USERNAME=
DB_PASSWORD=

设置创建项目的目录路径

可以将项目安装在任何目录中。以下示例为在Users > hoge > fuga下的path_to_project_dir文件夹中创建项目的设置。

BD_DATA_DIR=/Users/hoge/fuga/path_to_project_dir

其他

包括邮件发送服务器等设置项。根据需要修改。

4. 初始化数据库

php artisan migrate --seed;

使用SQLite数据库系统的注意事项

如果使用SQLite,则需要先创建空的数据文件。

如果需要使用相对路径指定数据库路径,则在执行migrate命令时需要注意。实际应用程序是在以public/为起点的相对路径下执行的。migrate命令需要在相同的当前目录下执行。

DB_DATABASE的值设置为以public/为起点的相对路径,并在public目录中执行migrate。

cd public/;
touch ../bd_data/database.sqlite;
php ../artisan migrate --seed;
cd ..;

启动服务器进行确认

以上设置完成。执行以下命令启动服务器并确认。

php artisan serve;

启动正常后,可以通过http://127.0.0.1:8000访问。如果浏览器显示初始界面,则表示设置完成。

cron命令设置

* * * * * apache cd /path/to/burdock && php artisan schedule:run >> /dev/null 2>&1

使用Redis设置WebSocket环境

利用WebSocket环境,可以添加与服务器进行异步对话的功能。特别是对于发布等耗时处理,可以大大提高便利性。

此设置是可选的。

需要安装Redis和Laravel Echo Server。

brew install redis;
npm install -g laravel-echo-server;

设置Laravel Echo Server。通过以下命令回答问题,将创建laravel-echo-server.json

laravel-echo-server init;

.env文件中,将BROADCAST_DRIVER设置为redis

BROADCAST_DRIVER=redis

启动

使用以下命令启动Redis、Laravel Echo Server和Laravel Queue等。

redis-server --daemonize yes;
pm2 start laravel-echo-server-pm2.json;
pm2 start node/watcher.js;
nohup php artisan queue:work --timeout=30000 > /dev/null 2>&1 &;

Artisan命令

indigo:cron

触发Indigo的发布处理。

bd:deploy-script

触发Indigo发布处理的后处理。

bd:generate_vhosts

输出Apache的Virtual Hosts设置文件。

系统要求 - 系统要求

推荐环境

根据插件或其他包的配置,可能需要满足额外的要求。请也确认依赖包的系统要求。

更新日志 - Change log

Pickles 2 Burdock v0.1.4 (2021年7月10日)

  • 修复了 composer update 无法执行的问题。

Pickles 2 Burdock v0.1.3 (2021年6月26日)

  • 修复了在创建的新 Broccoli 内容中无法配置模块的问题。

Pickles 2 Burdock v0.1.2 (2021年6月12日)

  • 在定期批处理中添加了物理删除逻辑删除的旧数据的处理。
  • 添加了新的设置项 BD_SOFTDELETE_RETENTION_PERIODBD_LOG_RETENTION_PERIODBD_USER_TEMPORARY_RETENTION_PERIOD
  • 添加了新的设置项 BD_URL_SCHEME
  • 添加了空间管理菜单。
  • 其他细微修正。

Pickles 2 Burdock v0.1.1 (2021年6月7日)

  • 修复了使用 Git 功能无法显示状态信息的问题。
  • 修复了在执行 Composer 操作和清除缓存时无法显示结果的问题。
  • 修复了在更新项目信息时被提示重新设置的问题。
  • 现在可以自动生成本环境的主机名 {$project_code}---production
  • 现在可以生成用于查看本环境预览、发布和备份的主机名。
  • bd:generate_vhosts 的执行间隔更改为每小时一次。
  • 现在可以更改内容的编辑方法。
  • 将内容编辑器的 viewport 更改为 width=1366
  • 修复了在文件和文件夹中,当 Pickles 2 项目准备不充分时,一些 CRUD 操作无法执行的问题。
  • 对项目 $conf->plugins->px2dt->main_menu 进行了支持。现在可以按项目定制主菜单。
  • 对项目 $conf->plugins->px2dt->appearance->main_color 进行了支持。
  • 修复了文件上传对话框无法操作的问题。
  • 其他细微修正。

Pickles 2 Burdock v0.1.0 (2021年5月28日)

  • 将预览环境的分隔符更改为四个连字符。
  • 现在 BD_PREVIEW_DOMAINBD_STAGING_DOMAIN 可以使用通配符。
  • Project Code 必须以半角英数字开头。
  • 添加了新的设置项 BD_APP_COPYRIGHT

Pickles 2 Burdock v0.0.1 (2021年5月25日)

  • 首次发布。

许可 - License

MIT 许可证

开发者信息 - for Developer

数据库的假数据填充

$ php artisan db:seed --class=DummyDataSeeder