Drupal本地导入显示默认站点 如何加载目标项目代码

一、XAMPP环境加载指定Drupal项目的配置方法 #

• 代码部署：将目标Drupal项目的完整代码包放置到XAMPP的htdocs目录下，建议单独创建独立项目文件夹，避免与其他Drupal安装包文件混淆。部署完成后确认项目根目录存在index.php、core、modules、themes、sites等Drupal标准目录结构，删除目录下残留的默认Drupal安装包冗余文件。
• 数据库对接：启动XAMPP控制面板中的Apache、MySQL服务，通过phpMyAdmin新建独立数据库，将目标项目的数据库备份文件完整导入该库。打开项目路径下sites/default/settings.php配置文件，修改数据库连接参数，与本地环境信息匹配：数据库主机填localhost，用户名默认root，密码留空（XAMPP默认MySQL配置），数据库名填写刚导入备份的库名，同时保留项目原配置中的$settings['hash_salt']值，不要使用默认安装生成的配置。
• 访问路径配置：推荐配置虚拟主机避免路径解析错误，打开Apache的httpd-vhosts.conf配置文件，添加指向项目目录的虚拟主机规则：

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/your_target_project"
    ServerName drupal-local.test
    <Directory "C:/xampp/htdocs/your_target_project">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

修改系统hosts文件添加解析规则127.0.0.1 drupal-local.test，重启Apache服务后通过配置的本地域名访问项目即可。

• 缓存清理：若访问仍显示异常，直接删除sites/default/files目录下的php、css、js子目录内所有缓存文件，Drupal会在访问时自动重新生成对应资源。

注意：不要触发Drupal全新安装流程，若页面自动跳转到安装向导，优先检查数据库连接配置是否正确、settings.php文件权限是否可被正常读取，重新安装会覆盖原有配置与数据库数据，导致回到默认站点状态。

二、Drupal站点代码的定位与加载逻辑 #

Drupal按固定层级规则加载站点代码，不会跨目录读取无关文件，核心流程如下：

• 入口引导阶段：请求首先命中项目根目录的index.php，加载Drupal核心引导文件，随后读取sites目录下的配置：多站点场景下会匹配当前访问域名对应的站点子目录，单站点场景默认读取sites/default目录下的settings.php，获取数据库连接信息、激活模块列表、主题路径等核心配置。
• 数据读取阶段：完成数据库连接后，从库中读取站点的激活模块清单、默认主题配置、页面内容数据等持久化存储的站点信息。
• 前端渲染阶段：根据数据库中存储的主题配置，到根目录themes文件夹下查找对应主题资源，按照主题定义的模板、样式、脚本逻辑渲染页面；若指定主题文件不存在或配置丢失，会自动 fallback 到Drupal核心自带的默认主题，即当前看到的默认站点页面。
• 业务逻辑加载阶段：核心功能逻辑从core/modules目录加载，第三方贡献模块、自定义业务模块从根目录modules目录加载，仅数据库中标记为启用状态的模块会被加载执行。

出现默认站点显示的核心原因通常为两类：一是部署的代码包为Drupal原生默认安装包，未替换为目标项目的完整代码；二是数据库连接指向空库或全新安装生成的库，未导入目标项目的原有数据库，Drupal读取不到原有项目的主题、模块配置，就会加载核心默认内容。

当前页面显示效果参考截图

内容的提问来源于stack exchange，提问作者JoRo