我们今天使用 Composer 安装 Drupal，并且搭建开发环境，做个详细的记录。

  • IDE：PyCharm
  • CMS：Drupal 8（9也可以，但是目前有很多插件不支持）
  • PHP环境：PHP7.4 + Composer 2
  • 开发环境：WSL2（Ubuntu 20.04） + Docker（3.2.2）
  • 系统环境：Windows 10

相关目录：

  • 项目目录 APP_DIR

环境配置

Windows 配置

安装好 PyCharm、Docker

WSL2 安装配置

WSL 是 Windows Subsystem for Linux 的缩写。
详细配置参考（待写）
系统选择 Ubuntu 20.04。

Docker 配置

图片.png
这里，我们把 Ubuntu-20.04 勾选上。

创建 Drupal 项目文件

我们由于我们使用的是 Composer 安装 Drupal，所以先要准备好 PHP 和 Composer，注意要在 WSL（Ubuntu）中安装。

PHP 和 Composer 的安装参考：Ubuntu 20.04 PHP 7.4 部署
使用 Composer 安装 Drupal 参考官方文档：Using Composer to Install Drupal and Manage Dependencies
在 Ubuntu 中，进入准备生成项目的路径，输入命令：

  1. composer create-project drupal/recommended-project:8.9.13 MY_SITE_NAME_DIR

图片.png
创建项目成功页面。

添加 git 保存

新建 .gitignore 文件，并将其余几个文件都放到 git 提交。

  1. # 自定义
  2. ## IDE
  3. /.idea
  4. /.vscode
  5. ## 挂载目录
  6. /volume
  7. ## 下载模块和插件目录
  8. /web/modules/contrib
  9. /web/themes/contrib
  11. # Created by .ignore support plugin (hsz.mobi)
  12. ### Drupal template
  13. # gitignore template for Drupal 8 projects
  14. #
  15. # earlier versions of Drupal are tracked in `community/PHP/`
  17. # Ignore configuration files that may contain sensitive information
  18. /web/sites/*/*settings*.php
  19. /web/sites/*/*services*.yml
  21. # Ignore paths that may contain user-generated content
  22. /web/sites/*/files
  23. /web/sites/*/public
  24. /web/sites/*/private
  25. /web/sites/*/files-public
  26. /web/sites/*/files-private
  28. # Ignore paths that may contain temporary files
  29. /web/sites/*/translations
  30. /web/sites/*/tmp
  31. /web/sites/*/cache
  33. # Ignore testing related files
  34. /web/sites/simpletest
  36. # Ignore drupal core (if not versioning drupal sources)
  37. /web/core
  38. /vendor
  39. /web/modules/README.txt
  40. /web/profiles/README.txt
  41. /web/themes/README.txt
  42. /web/sites/README.txt
  43. /web/sites/example.sites.php
  44. /web/sites/example.settings.local.php
  45. /web/sites/development.services.yml
  46. /web/.csslintrc
  47. /web/.editorconfig
  48. /web/.eslintignore
  49. /web/.eslintrc.json
  50. /web/.gitattributes
  51. /web/.ht.router.php
  52. /web/.htaccess
  53. /web/autoload.php
  54. /web/example.gitignore
  55. /web/index.php
  56. /web/INSTALL.txt
  57. /web/LICENSE.txt
  58. /web/README.txt
  59. /web/robots.txt
  60. /web/update.php
  61. /web/web.config

添加 .dockerignore ，减小不必要的打包本地文件体积，提高速度。排除文件基本与 .gitignore 相同，但要注意，路径要使用 web/core 而不是 /web/core 。

配置 PyCharm

使用 PyCharm 打开项目目录，菜单栏“文件” -> “设置”-> “PHP”
图片.png
先按如上图所示，新建并选择 Ubuntu-20.04 作为 CLI解释器。

图片.png
再按照如上图所示，选择并配置 composer.json 文件和解释器。

其他请参考 cy-website 项目