maximaster / bitrix-cli-install
从分发版或通过控制台命令安装 Bitrix 或备份数据。无需启动 Web 服务器
Requires
- php: >=7.2
- ext-dom: *
- ext-json: *
- guzzlehttp/guzzle: ^6.5
- maximaster/cli-ent: *
- myclabs/php-enum: ^1.7
- patchranger/cartesian-iterator: ^0.07.0
- symfony/console: 5.*
- symfony/css-selector: ^5.1
- symfony/dom-crawler: ^5.1
- symfony/event-dispatcher: 5.*
- symfony/polyfill-php80: @stable
- symfony/yaml: 5.*
Suggests
- ext-zip: Для установки ZIP-дистрибутивов
This package is auto-updated.
Last update: 2024-09-25 23:19:09 UTC
README
通过控制台从分发版或备份安装 Bitrix。无需启动 Web 服务器。
使用
可以通过使用 --help 调用命令来查看命令文档。通过调用 list 命令,可以查看可用命令列表。
原则上,支持通过全局安装 Composer 或通过 Docker 使用。在两种情况下,都使用 .env 文件来放置一系列环境变量(见配置重写)
通过全局安装 Composer
composer global require maximaster/bitrix-cli-install source .env && bitrix-cli-install bitrix:install https://www.1c-bitrix.ru/download/start_encode.zip ~/projects/bitrix/public
需要安装 ext-runkit(7)
通过 docker
BITRIX_DB_HOST=$(docker run --rm bash ip -4 route show default | cut -d" " -f3) \ docker run --rm -it \ -v $HOME/projects/bitrix/public:/tmp/bitrix-cli-install \ --env-file=.env -e BITRIX_DB_HOST \ maximaster/bitrix-cli-install bitrix:install \ https://www.1c-bitrix.ru/download/start_encode.zip /tmp/bitrix-cli-install
配置重写
安装顺序由配置 YAML 文件确定,该文件实际上描述了在哪些步骤中发送哪些数据到表单。默认使用 config/default.yaml
文件,但可以使用 --wizard-config
选项指定自己的文件。使用标准配置文件时,可以通过环境变量重写一系列参数
- BITRIX_DB_HOST
- BITRIX_DB_NAME
- BITRIX_DB_LOGIN
- BITRIX_DB_PASSWORD
- BITRIX_ADMIN_LOGIN
- BITRIX_ADMIN_PASSWORD
- BITRIX_ADMIN_EMAIL
开发
首先需要启动带有当前代码映射的镜像,以便可以实时更改,同时映射安装目录和数据库访问
make develop document-root=$PWD/tmp
可选地,可以指定 with
参数,这将允许通过 -e ENV_VAR=value
将额外的数据传递给 docker-compose run
,例如环境变量。
将进入容器控制台。其中包含与主机系统相同的代码,因此第一次不会存在 vendor
目录,需要创建它
composer install
之后,可以根据其文档使用控制台工具
bitrix-cli-install --help
需要在 $BITRIX_DIR
中安装,因为正是这个目录通过 make develop
命令的 document-root 参数映射到主机系统。容器内安装示例
bitrix-cli-install bitrix:install https://www.1c-bitrix.ru/download/start_encode.zip $BITRIX_DIR
默认情况下,通过主机机器的地址连接到数据库,其余参数根据环境变量。
如果需要通过 XDebug 进行调试,需要启用它
make debug-on
当使用 PHPStorm 时,开始调试所需的最小准备步骤如下
- 创建一个名为 bitrix-cli-install 的服务器,在目录映射中指定
/var/www
- 确保在设置中设置了端口
9000
- 启用 XDebug 连接监听