GitList 安装及使用教程

GitList 是一个优雅且现代的 Git 仓库查看器，它允许您通过浏览器浏览多个 Git 仓库，查看不同修订版下的文件、提交历史和差异。本教程将指导您完成安装并了解其关键组件。

1. 项目目录结构及介绍

在 gitlist 根目录下，您可以找到以下主要文件夹和文件：

• src - 包含主要的 PHP 代码，包括控制器、模型和服务。
• themes - 存放可选的界面主题。
• tests - 单元测试和集成测试所在的位置。
• config - 配置文件通常位于此处。
• cache - 缓存文件存储的地方。
• vendor - 使用 Composer 管理的第三方依赖包。
• index.php - 项目启动文件，处理 HTTP 请求。
• composer.json - 描述项目依赖和元数据的文件。
• build.xml - Apache Ant 构建脚本，用于构建和打包项目。
• README.md - 项目简介。
• LICENSE.txt - 许可证信息。

2. 项目启动文件介绍

• index.php
  这是 GitList 的入口点。该文件负责加载自动加载器以解析类，然后初始化 Silex 应用框架，加载配置并处理请求。默认情况下，它从 config.ini.example 加载配置（确保根据您的环境进行修改）。

// ... 其他代码 ...
require __DIR__.'/vendor/autoload.php';

use Silex\Application;
use GitList\App;

$env = getenv('APP_ENV') ?: 'prod';
$debug = ($env === 'dev' || $env === 'test');

$app = new Application(['debug' => $debug]);
require __DIR__.'/src/bootstrap.php';
return App::run($app);

3. 项目配置文件介绍

• config.ini.example
  这个是配置示例文件，用于设置 GitList 的行为。例如，您可以配置 Git 可执行文件的路径、缓存设置以及访问控制。要启用此配置，首先创建一个名为 config.ini 的副本，并根据您的需求编辑它。

[git]
; Path to the git binary
binary = /usr/bin/git

[caching]
enabled = true
directory = data/cache

[servers]
default =
    ; repo_path: Relative or absolute path to the git repositories directory
    repo_path = /var/repositories
    ; theme: Theme to use (change this from the list available in themes/)
    theme = default
    ; allow_push: Enable push operations (false by default)
    allow_push = false

[access_control]
; If enabled, you must provide a username and password in order to access GitList
; Set the environment variables PASSWD_FILE and USER_FILE to the paths of your user and passwd files
enabled = false
passwd_file =
user_file =

; [logging]
; level = info

要使更改生效，记得重启 GitList。

---

以上是 GitList 的基本安装和配置指南。了解更多详细信息，可以参考项目仓库中的 README 文件或参与项目社区讨论。祝您使用愉快！