波士顿官网（boston.gov）开源项目启动与配置教程

1. 项目目录结构及介绍

波士顿官网（boston.gov）开源项目是基于Drupal构建的。项目目录结构如下：

• build/：构建过程中产生的文件。
• docker/：包含Docker相关配置文件。
• dockerfiles/：自定义的Dockerfile。
• docroot/：Drupal的核心文件和网站文档根目录。
  • profiles/：Drupal安装配置文件。
  • sites/：包含网站默认设置、模块、主题和特征。
• guides/：开发指南和文档。
• gulp-tasks/：使用Gulp的任务脚本。
• hooks/：Drupal钩子脚本。
• lando/：Lando配置文件，用于本地开发环境。
• libraries/：外部库和依赖。
• patches/：补丁文件。
• scripts/：脚本文件，包括初始化容器等。
• tests/：测试脚本和文件。
• .dockerignore：Docker构建时需要忽略的文件。
• .gitignore：Git版本控制时需要忽略的文件。
• .lando.yml：Lando开发环境的配置文件。
• .travis.yml：Travis CI持续集成配置文件。
• composer.json：项目依赖和Composer配置。
• composer.lock：Composer依赖锁定文件。
• docker-compose.yml：Docker Compose配置文件。
• gulpfile.js：Gulp配置文件。
• hub-task.sh：用于Hub环境的脚本。
• issue_template.md：GitHub问题模板。
• make.yml：构建配置文件。
• package-lock.json：npm依赖锁定文件。
• package.json：npm配置文件。
• project.yml：项目配置文件。
• pull_request_template.md：GitHub拉取请求模板。
• task.sh：执行任务的脚本。

2. 项目的启动文件介绍

项目的启动主要通过Docker Compose进行。以下是启动文件docker-compose.yml的主要内容：

version: '3.1'
services:
  drupal:
    image: docker.boston.gov/bostongov-drupal:latest
    ...
    volumes:
      - ./docroot:/var/www/html:rw
    ...
    networks:
      - bostongov

  db:
    image: mysql:5.7
    ...
    volumes:
      - db_data:/var/lib/mysql
    ...
    networks:
      - bostongov

networks:
  bostongov:

volumes:
  db_data:

此文件定义了Drupal服务和数据库服务的配置，包括使用的镜像、数据卷、网络等。

3. 项目的配置文件介绍

项目的配置文件包括Drupal设置文件和Docker环境配置文件。

• docroot/sites/default/settings.php：Drupal的主要设置文件，包含数据库连接信息、文件系统路径、缓存设置等。

$databases['default']['default'] = array (
  'driver' => 'mysql',
  'database' => 'drupal',
  'username' => 'drupal',
  'password' => 'drupal',
  'host' => 'db',
  'port' => '3306',
  'prefix' => '',
);

• .lando.yml：Lando开发环境的配置文件，定义了本地开发环境的设置。

name: bostongov
config:
  php: "7.2"
  webroot: docroot
  database:
    hostname: db
    name: drupal
    user: drupal
    password: drupal

以上信息提供了项目的目录结构、启动文件和配置文件的基本介绍。在实际使用中，可能还需要根据实际情况进行相应的调整和配置。