Drupal建站教程：企业级CMS安装配置指南

Drupal是一款功能强大的开源企业级内容管理系统，采用PHP语言开发，以GPLv2+协议开源。Drupal以其高度的灵活性、可扩展性和安全性著称，被广泛用于政府、高校、媒体、企业等大型网站建设。全球超过100万个网站使用Drupal，包括联合国、白宫、NASA等知名机构。

核心优势：强大的内容建模能力、多语言支持、企业级权限管理、高性能缓存、模块化架构、API优先设计。适合中大型企业网站、社区平台、多语言站点和复杂内容架构项目。

环境要求

• Web服务器：Nginx 1.20+ 或 Apache 2.4+
• PHP版本：PHP 8.1 ~ 8.3（Drupal 11推荐PHP 8.2+）
• 数据库：MySQL 5.7.8+ / MariaDB 10.3.7+ / PostgreSQL 12+
• 内存：最低1GB，推荐2GB以上
• 磁盘：至少500MB可用空间
• PHP扩展：pdo_mysql、gd、curl、mbstring、json、opcache、xml、zip、intl
• Composer：用于依赖管理（推荐）

安装教程

步骤1：环境准备与Composer安装

Drupal推荐使用Composer管理项目依赖。先安装Composer：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
composer --version

步骤2：使用Composer创建Drupal项目

cd /www/wwwroot
composer create-project drupal/recommended-project yourdomain.com
cd yourdomain.com

这会创建标准的Drupal项目结构，web目录为网站根目录。

步骤3：创建数据库

mysql -u root -p
CREATE DATABASE drupal DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'drupal_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON drupal.* TO 'drupal_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步骤4：配置文件权限

chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com/web
mkdir -p /www/wwwroot/yourdomain.com/web/sites/default/files
chmod 775 /www/wwwroot/yourdomain.com/web/sites/default/files
cp /www/wwwroot/yourdomain.com/web/sites/default/default.settings.php /www/wwwroot/yourdomain.com/web/sites/default/settings.php
chmod 664 /www/wwwroot/yourdomain.com/web/sites/default/settings.php

步骤5：Nginx配置

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /www/wwwroot/yourdomain.com/web;
    index index.php index.html;

    location = /favicon.ico { log_not_found off; access_log off; }
    location = /robots.txt { log_not_found off; access_log off; allow all; }

    location ~* \.(css|gif|ico|jpeg|jpg|js|png|svg|woff|woff2|ttf|eot)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-82.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_read_timeout 300;
    }

    location ~ /\.ht {
        deny all;
    }
}

步骤6：运行安装向导

浏览器访问 http://yourdomain.com：

1. 选择安装语言（简体中文）
2. 选择安装配置文件（标准安装）
3. 验证环境要求（如有缺失需修复）
4. 填写数据库配置（数据库名、用户名、密码、主机）
5. 配置站点信息（站点名称、邮箱、管理员账号密码）
6. 等待安装完成，自动进入网站

步骤7：安装后安全设置

chmod 644 /www/wwwroot/yourdomain.com/web/sites/default/settings.php
chmod 755 /www/wwwroot/yourdomain.com/web/sites/default

Windows环境安装（phpStudy集成环境）

对于Windows用户，推荐使用phpStudy或XAMPP集成环境快速搭建：

1. 下载安装phpStudy（https://www.xp.cn）或XAMPP（https://www.apachefriends.org）
2. 启动集成环境，开启Apache/Nginx和MySQL服务
3. 将程序源码解压到网站根目录（phpStudy默认是WWW目录，XAMPP默认是htdocs目录）
4. 打开phpMyAdmin创建数据库（访问http://localhost/phpmyadmin）
5. 浏览器访问http://localhost，按照安装向导完成安装

注意：Windows环境仅推荐用于本地开发和测试，生产环境建议使用Linux服务器。

宝塔面板安装（推荐）

宝塔面板是国内最流行的服务器管理面板，支持一键部署PHP环境和网站：

1. 安装宝塔面板：CentOS执行yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh，Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
2. 安装完成后，登录宝塔面板（地址和账号密码在安装完成后显示）
3. 首次登录提示安装LNMP/LAMP环境，选择Nginx + MySQL + PHP，点击一键安装
4. 点击”网站” → “添加站点”，填写域名、选择PHP版本、创建数据库
5. 将程序源码上传到网站根目录（/www/wwwroot/你的域名）
6. 设置目录权限：在文件管理器中选中网站目录，权限设置为755，所有者为www
7. 浏览器访问域名，按照安装向导完成安装

宝塔面板优势：可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。

服务器配置建议

• PHP内存限制：memory_limit = 256M（大型站点建议512M）
• 上传文件大小：upload_max_filesize = 32M，post_max_size = 32M
• 最大执行时间：max_execution_time = 300
• 启用OPcache，设置opcache.memory_consumption=128
• 配置Redis作为缓存后端（需安装Redis模块）
• 启用Drupal内置的页面缓存和动态页面缓存
• 配置CDN加速静态资源
• 定期运行composer update更新核心和模块

常见问题

Q：安装时提示”需要启用PHP扩展”？
A：根据提示安装对应扩展，如apt install php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip

Q：Composer安装超时或失败？
A：配置国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

Q：后台页面空白或500错误？
A：检查PHP错误日志，通常是内存不足或扩展缺失。增加memory_limit到256M。

Q：如何更新Drupal核心？
A：在项目根目录执行：composer update drupal/core --with-dependencies，然后运行drush updatedb或访问update.php。

官方网址

官方网站：https://www.drupal.org

下载地址：https://www.drupal.org/download

官方文档：https://www.drupal.org/docs

模块/主题：https://www.drupal.org/project/project_module