# tp6_vqmod

**Repository Path**: pgcao/tp6_vqmod

## Basic Information

- **Project Name**: tp6_vqmod
- **Description**: 全网首个VQMOD+Thinkphp6项目，官方更新了版本不需要重复去修改原已改动过的文件，进而可快速升级TP版本。完全免费可商用！
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2021-12-12
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vqmod, ThinkPHP

## README

![vQmodTP6+](README.png)

# VQmod For ThinkPHP 6+

> 关于 VQMOD

vQmod（全称 Virtual Quick Mod，又称为虚拟快速模块）是一个快速覆盖原有 PHP 系统代码的编程机制。

可以在不修改系统原有文件的情况下，对原系统的功能做任意改进，这样做的一个很大的好处是新系统不会因为二次开发而导致不能把原系统升级到最新版本。而在性能方面基本上可以忽略不计，特别是运行于长驻内存的 PHP 项目，我一直使用这个组合，对于二开时需要改 TP 核心代码是相当快捷而无后患。经过长时间使用，现在分享出来给大家，希望你也会喜欢它。

实现原理过程实际上非常简单 - 通过 xml 文件进行对特定的 PHP 文档进行搜索/替换代码，并修改为被指定内容然后生成一个新缓存文件进行使用。

本项目是将 vQmod 结合 ThinkPHP6+使用，方便平时进行开发，实际项目中需要改动 TP 官方核心代码来满足自己需求时，可快速无损进行处理，后期 Thinkphp 官方更新了版本不需要重复去修改原已改动过的文件，进而可快速升级 TP 版本。

[更多请参阅 vQmod 仓库](https://github.com/vqmod/vqmod/releases)

## 下载项目包

克隆或下载 [本项目仓库代码](https://gitee.com/pgcao/tp6_vqmod/repository/archive/master.zip) 到本地，进入 tp6_vqmod 项目目录，安装好依赖

## 安装 TP 相关依赖

```
composer install
```

> 安装依赖时忽略 PHP 版本不匹配警告

```
composer install --ignore-platform-reqs
```

> 更新依赖时忽略 PHP 版本不匹配警告

```
composer update --ignore-platform-reqs
```

> 如果需要更新 TP 框架使用

```
composer update topthink/framework
```

## 运行

```
php think run
```

即可愉快地使用 vQmod 带来的便利啦~

# 现有的项目如何使用 vQmod?

只需将本项目中的 extend/vqmod 目录放置进你的 TP6+ 项目根下的 extend 目录内

## 执行安装

```
composer require iocui/vqmod
```

控制台若显示 **VQMod install succee!** 即表示你现有的 TP6+ 项目已无缝使用上 vQmod，然后甚至你可以用 vQmod 的机制来做你的项目插件。

> 如果你不想再继续使用 vQmod, 只需要将 ```extend/vqmod``` 目录直接删除或运行命令 ```composer remove iocui/vqmod``` 即可，但之前用 vQmod 处理的代码将无法再继续使用。

在性能上，经多个投产项目实际使用，并没有太多差别。对于要常改核心代码或想做插件开发的项目来说，vQmod 是一个很不错的选择 ^\_^

更多vqmod相关示例：[vQmod Examples](https://github.com/vqmod/vqmod/wiki/Examples)

> 实战使用请参阅本项目目录下的 extend/vqmod/xml/iocui_tp6_patch.xml 文件使用示例

# 关于 ThinkPHP 6+

[前往官方 Gitee 仓库](https://gitee.com/liu21st/thinkphp) | [`ThinkAPI`——官方统一 API 服务](https://docs.topthink.com/think-api)