关于 bitrix-console-commands
面向 Bitrix 站点开发者的 `bitrix.php` 命令行使用指南,涵盖命令发现、执行条件、生成器及 cron 和 CI 的注意事项。
主要功能
- 01列出并查看命令
- 02运行 `make:*` 生成器
- 03了解命令注册方式
- 04遵循 cron 和 CI 要求
适用场景
- 01查找 Bitrix 站点可用命令
- 02使用 `make:service` 生成服务
- 03配置自定义命令或 cron 任务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-console-commands安装后在 Claude Code 中输入/bitrix-console-commands确认已加载。
附带文件rules/custom-command.mdrules/generators.md
详细介绍
Bitrix 控制台(bitrix.php)
基线:main 23.0+ · 已验证:main 26.800.0
cd /var/www/site && php bitrix/bitrix.php list # or: cd bitrix && php bitrix.php list
php bitrix/bitrix.php help make:service
php bitrix/bitrix.php make:service Post -m vendor.blog -n # -n: no questions
| 任务 | 阅读 |
|---|---|
25.x 中已有的 make:* 生成器及其输出路径 | rules/generators.md |
内核命令:orm:annotate、messenger:consume、update:*、translate:index | rules/generators.md |
| 自定义命令、注册、cron | rules/custom-command.md |
不变量
- 需要 Composer 提供 Symfony Console:
composer.json中包含symfony/console,且.settings.php配置了composer.config_path(bitrix-settings);否则,bitrix.php会打印“Symfony Console is not installed”。 DOCUMENT_ROOT根据getcwd()和脚本路径推导:请从站点根目录或bitrix/目录运行,不要在其他目录中运行php /abs/path/bitrix.php。- 命令仅来自已安装模块的
.settings.php→console.commands;全局/local/.settings.php不是命令来源。 - 内核会执行
new $commandClass(),不会注入构造函数依赖;请在execute()中解析服务(bitrix-framework)。 - 在 cron 和 CI 中始终使用
-n/--no-interaction。
评论
支持 Markdown