用途:面向 Bitrix 框架开发者,整理 bitrix.php 命令行控制台的使用方式。基线为 main 23.0+,验证版本为 main 26.800.0。
主要能力:列出并运行控制台命令,例如从站点根目录执行 cd /var/www/site && php bitrix/bitrix.php list(或 cd bitrix && php bitrix.php list)。包含 make:* 生成器,可生成模块、控制器、tablet、service、event、message、agent 等(25.x 可用),相关输出路径与规则见 rules/generators.md。内核命令包括 orm:annotate、messenger:consume、update:*、translate:index。
用法:查看帮助可执行 php bitrix/bitrix.php help make:service;生成服务示例为 php bitrix/bitrix.php make:service Post -m vendor.blog -n,其中 -n 表示不提问。自定义命令的编写、注册与 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/ 下运行,不要在其他目录用绝对路径调用。命令仅来自已安装模块的 .settings.php → console.commands,全局 /local/.settings.php 不是来源。内核直接 new $commandClass(),不支持构造函数依赖注入,需在 execute() 中解析服务(bitrix-framework)。在 cron 与 CI 中始终使用 -n/--no-interaction。
适用场景:Bitrix 项目的命令行代码生成、ORM 注解、消息消费、更新与翻译索引等日常开发运维任务。其余费用、平台与效果信息暂未提供。