开源项目教程：Ayesh/Composer-Preload 使用指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00542/article/details/141586796

开源项目教程：Ayesh/Composer-Preload 使用指南

Composer-PreloadPreload your sweet sweet code to opcache with a composer command, making your code faster to run.项目地址:https://gitcode.com/gh_mirrors/co/Composer-Preload

项目概述

Ayesh/Composer-Preload 是一个专为加速PHP应用运行而设计的Composer插件。它通过一个自定义命令 composer preload 来预热OPCache，即在应用部署时将指定的PHP代码预先编译到OPCache中，从而提高代码执行速度。本指南旨在帮助开发者了解此项目的基本结构、关键文件以及配置方法。

1. 项目目录结构及介绍

Ayesh/Composer-Preload 的基本目录结构保持了标准的PHP Composer包布局：

src : 包含核心的插件实现代码。
tests : 存放用于测试插件功能的单元测试文件。
.gitattributes, .gitignore : 版本控制相关配置，指导哪些文件应纳入或排除于版本管理。
LICENSE : 许可证文件，声明该项目遵循MIT协议。
README.md : 项目的主要说明文档，包含了快速入门和基本信息。
composer.json : Composer配置文件，定义了依赖关系、作者信息以及提供该插件所需的元数据。
phpunit.xml.dist : PHPUnit测试框架的配置文件。

2. 项目的启动文件介绍

本项目的核心并不是通过直接“启动”某个文件来运作的，而是集成在 Composer 环境中。主要交互点是 Composer 自带命令的扩展，特别是 composer preload 命令。当开发者执行这个命令时，Ayesh/Composer-Preload 插件被激活，扫描指定路径下的PHP文件并生成一个vendor/preload.php文件，用于预加载到OPCache中，间接地“启动”了其优化过程。

3. 项目的配置文件介绍

配置主要通过修改项目根目录下的 composer.json 文件来完成。你需要在 extra 字段下添加特定的 preload 配置，如下示例所示：

{
    "extra": {
        "preload": {
            "paths": [
                "web"
            ],
            "exclude": [
                "web/core/tests",
                "web/core/lib/Drupal/Component/Assertion",
                "web/core/modules/simpletest",
                "web/core/modules/editor/src/Tests"
            ],
            "extensions": ["php", "module", "inc", "install"],
            "exclude-regex": "/[A-Za-z0-9_]test\\ php$/i",
            "no-status-check": false,
            "mechanism": "compile",
            "files": [
                "somefile.php"
            ]
        }
    }
}

paths: 指定需要扫描以预加载的目录路径。
exclude: 排除不需要预加载的目录或文件模式。
extensions: 要考虑的文件扩展名列表。
exclude-regex: 排除模式的正则表达式，用于更细粒度的排除控制。
no-status-check: 控制是否跳过状态检查。
mechanism: 预加载的方式（如require_once或opcache_compile_file）。
files: 可选的特定文件列表，直接指定要预加载的文件路径。