maximaster / bitrix-cli-install

从分发版或通过控制台命令安装 Bitrix 或备份数据。无需启动 Web 服务器

0.3.0 2021-02-25 15:36 UTC

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 连接监听