TYPO3/Surf 项目启动与配置教程

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

TYPO3/Surf 的目录结构是为了支持其作为一个 distribution builder 的功能。以下是主要目录及其功能的简要介绍：

• typo3/: 这个目录包含了 TYPO3 CMS 的核心文件。
• contributions/: 包含了社区贡献的插件和扩展。
• distributions/: 存放不同的TYPO3 distributions，这些distribution是预配置的网站，包含了特定的扩展和设置。
• Packages/: 包含了所有需要安装的npm包。
• Build/: 存储构建过程中生成的文件。
• Resources/: 存储静态资源，如图片、样式表和JavaScript文件。
• bin/: 包含了可执行的脚本，如启动脚本。
• composer.json: 定义项目依赖的Composer包。
• README.md: 项目说明文件。
• .gitignore: 指定哪些文件和目录应该被Git忽略。

2. 项目的启动文件介绍

项目的启动主要通过 bin/surf 脚本进行。以下是启动文件的一些基本介绍：

• bin/surf: 这是项目的启动脚本，通常用于启动 Surf 应用。它是一个命令行工具，可以创建和管理 TYPO3 distributions。

要启动这个脚本，你需要确保你的系统中已经安装了Node.js。然后在命令行中执行以下命令：

./bin/surf

这个命令会启动 Surf 的交互式命令行界面，允许你创建新的distribution，安装扩展，以及执行其他相关的任务。

3. 项目的配置文件介绍

Surf 使用 surf.php 文件作为其主要的配置文件。以下是配置文件的一些基本介绍：

• surf.php: 这是 Surf 的配置文件，它定义了如何构建和部署 TYPO3 distributions。

配置文件通常位于项目的根目录下，它包含了一系列的配置选项，如：

• extensions: 定义了需要安装的 TYPO3 扩展。
• sites: 定义了不同的网站实例及其配置。
• tasks: 定义了执行部署时需要执行的任务。

以下是一个配置文件的示例：

<?php
return [
    'extensions' => [
        'example_extension' => ['version' => '1.0.0'],
    ],
    'sites' => [
        'example' => [
            'base' => 'https://example.com',
            'type' => ' TYPO3/CMS '
        ],
    ],
    'tasks' => [
        'TYPO3\\Surf\\Task\\ TYPO3 \\ CMS \\ Install \\ InstallTask' => [],
        'TYPO3\\Surf\\Task\\ TYPO3 \\ CMS \\ Update \\ UpdateTask' => [],
    ],
];

在这个配置文件中，你需要根据你的需求自定义扩展、网站和任务。配置完成后，你可以使用 Surf 工具来部署和更新你的 TYPO3 distributions。