Drupal 项目初始化与使用教程

Drupal 项目初始化与使用教程

drupal-project :rocket: Composer template for Drupal projects. Quick installation via "composer create-project drupal-composer/drupal-project" 项目地址: https://gitcode.com/gh_mirrors/dr/drupal-project

1. 项目的目录结构及介绍

Drupal 项目使用 drupal-composer/drupal-project 模板初始化时，会生成以下目录结构：

drupal-project/
├── composer.json          # Composer 配置文件，定义项目依赖
├── composer.lock          # Composer 锁文件，记录安装的依赖版本
├── docroot/               # Drupal 根目录，存放 Drupal 核心文件和模块
│   ├── core/              # Drupal 核心文件
│   ├── libraries/         # 第三方库文件
│   ├── modules/           # Drupal 模块目录
│   ├── profiles/          # Drupal 安装配置配置文件
│   ├── sites/             # 网站特定文件和配置
│   │   ├── default/       # 默认设置和文件
│   │   │   ├── files/     # 上传文件存储目录
│   │   │   └── settings.php # 网站设置文件
│   │   └── example.sites.php # 网站配置示例文件
│   └── themes/            # 主题目录
├── README.md              # 项目说明文件
├── robots.txt             # 网站机器人访问规则文件
└── .gitignore             # Git 忽略文件列表

这个结构为标准的 Drupal 项目提供了清晰的模块划分和配置管理。

2. 项目的启动文件介绍

启动文件主要包括 composer.json 和 composer.lock。

• composer.json：此文件用于定义项目的依赖。Drupal 项目需要很多依赖，例如 Drupal 核心文件、各种模块和库。通过在 composer.json 文件中声明这些依赖，可以使用 composer install 命令自动安装它们。

• composer.lock：此文件记录了项目的确切依赖版本，以确保其他开发者或部署到其他环境时，能够安装相同版本的依赖，从而保持环境的一致性。

3. 项目的配置文件介绍

配置文件主要是 docroot/sites/default/settings.php。

• settings.php：这是 Drupal 网站的主要配置文件。在此文件中，您可以设置数据库连接信息、定义文件系统路径、配置缓存和其他 Drupal 设置。以下是一些基本配置示例：

$databases = array (
  'default' =>
  array (
    'default' =>
    array (
      'driver' => 'mysql',
      'database' => 'drupal_db',
      'username' => 'drupal_user',
      'password' => 'drupal_password',
      'host' => 'localhost',
      'port' => '',
      ' Collation' => 'utf8mb4_general_ci',
    ),
  ),
);

// 配置文件系统路径
$settings['file_temp_path'] = '/path/to/temp';
$settings['file_public_path'] = 'sites/default/files';
$settings['file_private_path'] = 'sites/default/private';

// 开启缓存
$settings['cache'][' bins']['bootstrap'] = 'cache';
$settings['cache']['bins']['render'] = 'cache';

在配置 Drupal 时，请确保正确设置这些文件，以保持网站的安全和稳定运行。

drupal-project :rocket: Composer template for Drupal projects. Quick installation via "composer create-project drupal-composer/drupal-project" 项目地址: https://gitcode.com/gh_mirrors/dr/drupal-project