README

Bolt CMS 是一个开源、可定制的平台，用于构建和运行现代网站。基于 PHP、Symfony 等技术构建。更多信息请访问网站。

要检查 Bolt 并设置您的第一个 Bolt 安装，请阅读安装 Bolt 5。

安装 Bolt CMS

使用 Composer

注意：使用 Composer 安装并在本地机器上使用以下方法运行网站是 Bolt 核心开发团队的推荐方法。

使用以下命令设置新的 Bolt 5 项目，将 myprojectname 替换为您希望的项目名称。

composer create-project bolt/project myprojectname

进入新创建的文件夹，并在 .env 中配置数据库（配置旨在与 SQLite 数据库一起工作）。

# Configure database for doctrine/doctrine-bundle
# SQLite (note: _three_ slashes)
DATABASE_URL=sqlite:///%kernel.project_dir%/var/data/bolt.sqlite

# MYSQL / MariaDB
#DATABASE_URL=mysql://db_user:"db_password"@127.0.0.1:3306/db_name?serverVersion=5.7

# Postgres
#DATABASE_URL=postgresql://db_user:"db_password"@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8

设置数据库，创建第一个用户并添加固定内容（占位内容）

bin/console doctrine:database:create # Create database
bin/console doctrine:schema:create # Create schema in database

bin/console doctrine:fixtures:load --no-interaction # Load fixtures in databse (step not compulsory)
bin/console bolt:add-user --admin # Follow the creation steps in the console (warning: fixtures already created an admin user)

composer run post-create-project-cmd # Duplicate themes in the appropriate folder

bin/console bolt:info # Verify Bolt installation

使用内置的 web 服务器、Symfony CLI 或您自己的首选 web 服务器运行 Bolt

bin/console server:start

或…

symfony server:start -d
symfony open:local

最后，在浏览器中打开新的安装。如果您已使用上述命令之一，您将找到主页在http://127.0.0.1:8000/
Bolt 管理面板可以在http://127.0.0.1:8000/bolt找到

使用您设置第一个用户时创建的凭据登录。

注意：如果您不想使用 Docker，请勿忘记删除不必要的文件
- 删除 .dockerignore 文件
- 删除 docker-composer.yml 文件
- 删除 Dockerfile 文件
- 删除 docker 文件夹

使用 Docker

免责声明：Bolt 核心开发团队不使用 Docker。Bolt 可以 使用 Docker 运行，但建议只有当您自己有足够的 Docker 经验来理解 Dockerfile 和 docker-compose.yml 中的内容时才尝试此操作。提供的设置可能不适合您的 Dockerized 设置。如有疑问，请遵循有关在 Docker 中运行 Symfony 项目的通用建议，因为 Bolt 是使用 Symfony 开发的。Bolt 团队不提供预构建的容器。

首先，下载 Bolt 项目分布 .tar.gz 文件，或从我们提供的模板生成 GitHub 仓库。提取内容后，生成的目录包含 Bolt 项目结构。您将在其中添加自己的代码和配置。

注意：尽量不使用 .zip 文件，因为它可能引起潜在的权限问题。

Bolt 随附一个 Docker 设置，使创建容器化开发环境变得容易。如果您电脑上还没有 Docker，现在是安装它的时候了安装 Docker。

在 Mac 上，仅支持 Docker for Mac。同样，在 Windows 上，也仅支持 Docker for Windows。Docker Machine 不支持 默认安装。

打开终端，切换到包含您的项目框架的目录。

进入新创建的文件夹，并在 .env 文件中为 Docker 和 MySQL 5.7 版本的数据库配置环境变量。

###> symfony/framework-bundle ###
APP_ENV=dev
APP_DEBUG=1
APP_SECRET=!ChangeMe!
TRUSTED_PROXIES=127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16
TRUSTED_HOSTS='^(localhost|nginx)$'
###< symfony/framework-bundle ###

###> doctrine/doctrine-bundle ###
DATABASE_URL=mysql://bolt:!ChangeMe!@db:3306/bolt?serverVersion=5.7
###< doctrine/doctrine-bundle ###

###> symfony/mailer ###
MAILER_DSN=smtp://mailcatcher:1025
###< symfony/mailer ###

运行以下命令以使用 Docker Compose 启动所有服务

docker-compose up -d # Running in detached mode
docker-compose exec php bin/console doctrine:schema:create # Create schema in database
docker-compose exec php bin/console doctrine:fixtures:load --no-interaction # Load fixtures in databse (step not compulsory)
docker-compose exec php bin/console bolt:add-user --admin # Follow the creation steps in the console (warning: fixtures already created an admin user)

这将启动以下服务

docker-compose ps

docker-compose exec <container name> <command>
docker-compose exec php sh # To enter the container directly, you will be placed at the root of the project
docker-compose exec php bin/console bolt:add-user # Follow the creation steps in the console (warning: fixtures already created an admin user)

docker-compose logs        # Display the logs of all containers
docker-compose logs -f     # Same but follow the logs
docker-compose logs -f php # Follow the logs for one container

最后，在浏览器中打开新安装的软件。如果您使用过上面的命令之一，您将在 http://localhost:8080/ 或 https://localhost:8443/ 找到首页
Bolt 管理面板可以在 http://localhost:8080/bolt 或 https://localhost:8443/bolt 找到

测试

静态分析

• ECS - 易于编码标准

ecs.php 配置文件位于 cms 项目的根目录

# With Composer
composer lint                         # Launch ECS in dry run mode (command to launch in a Continuous Integration)
composer lint:fix                     # Launch ECS in fix mode

# With Docker
docker-compose exec php composer lint # Launch ECS by the php container

• PHPStan - PHP 静态分析工具

phpstan.neon 配置文件位于 cms 项目的根目录

# With Composer
composer phpstan                         # Launch PHPStan (command to launch in a Continuous Integration)

# With Docker
docker-compose exec php composer phpstan # Launch PHPStan by the php container

贡献

如果您想贡献，请检查 Bolt 核心存储库 并阅读 “为 Bolt 贡献” 文档页面。