Patcher
统一差异格式修补程序类
| 链接 |
它源于 Giuseppe Mazzotta 编写的 PhpPatcher 版本 0.1.1 |
|---|---|
| 自 |
3.0.0 |
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher 代替。 |
| 包 |
Joomla CMS |
方法
__construct
构造函数
__construct() :
构造函数受保护,以强制使用 FilesystemPatcher::getInstance()
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::__construct() 代替。 |
响应
混合
add
将统一差异字符串添加到修补程序
add( udiff, root = JPATH_BASE, strip) : \Joomla\CMS\Filesystem\Patcher
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::add() 代替。 |
参数
- udiff
string统一差异输入字符串- root
string文件根路径- strip
int要剥离的 '/' 的数量
响应
Patcher$this 用于链式操作
addFile
将统一差异文件添加到修补程序
addFile( filename, root = JPATH_BASE, strip) : \Joomla\CMS\Filesystem\Patcher
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::addFile() 代替。 |
参数
- filename
string统一差异文件的路径- root
string文件根路径- strip
int要剥离的 '/' 的数量
响应
Patcher$this 用于链式操作
apply
应用修补程序
apply() :
| 自 |
3.0.0 |
|---|---|
| 抛出 |
|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::apply() 代替。 |
响应
int已修补文件的数量
applyHunk
应用修补程序
applyHunk(mixed||string|int &lines, src, dst, srcLine, srcSize, dstLine, dstSize) :
| 自 |
3.0.0 |
|---|---|
| 抛出 |
|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::applyHunk() 代替。 |
参数
- lines
array<string|int, mixed>udiff 行数组- src
string源文件- dst
string目标文件- srcLine
string源文件的修补程序开头- srcSize
string源文件的修补程序大小- dstLine
string目标文件的修补程序开头- dstSize
string目标文件的修补程序大小
响应
void
findHeader
查找差异头
findHeader(mixed||string|int &lines, &src, &dst) :
$lines 的内部数组指针在找到的下一行
| 自 |
3.0.0 |
|---|---|
| 抛出 |
|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::findHeader() 代替。 |
参数
- lines
array<string|int, mixed>udiff 行数组- src
string源文件- dst
string目标文件
响应
bool成功时为 TRUE,失败时为 FALSE
findHunk
查找下一个差异部分
findHunk(mixed||string|int &lines, &srcLine, &srcSize, &dstLine, &dstSize) :
$lines 的内部数组指针在找到的下一行
| 自 |
3.0.0 |
|---|---|
| 抛出 |
|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::findHunk() 代替。 |
参数
- lines
array<string|int, mixed>udiff 行数组- srcLine
string源文件的修补程序开头- srcSize
string源文件的修补程序大小- dstLine
string目标文件的修补程序开头- dstSize
string目标文件的修补程序大小
响应
bool成功时为 TRUE,失败时为 false
getDestination
获取目标文件的行
getDestination( dst, src) : mixed||string|int
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::getDestination() 代替。 |
参数
- dst
string目标文件的路径- src
string源文件的路径
响应
array<string|int, mixed>目标文件的行
getInstance
获取修补程序的方法
getInstance() : \Joomla\CMS\Filesystem\Patcher
getSource
获取源文件的行
getSource( src) : mixed||string|int
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::getSource() 代替。 |
参数
- src
string文件的路径
响应
array<string|int, mixed>源文件的行
reset
重置修补程序
reset() : \Joomla\CMS\Filesystem\Patcher
splitLines
分隔 CR 或 CRLF 行
splitLines( data) : mixed||string|int
| 自 |
3.0.0 |
|---|---|
| 已弃用 |
4.4 将在 6.0 中删除,请使用 Joomla\Filesystem\Patcher::splitLines() 代替。 |
参数
- data
string输入字符串
响应
array<string|int, mixed>输入目标文件的行
常量
SRC_FILE
用于搜索源文件的正则表达式
| 值 | '/^---\s+(\S+)\s+\d{1,4}-\d{1,2}-\d{1,2}\s+\d{1,2}:\d{1,2}:\d{1,2}(\.\d+)?\s+(\+|-)\d{4}/A' |
|---|
DST_FILE
用于搜索目标文件的正则表达式
| 值 | '/^\+\+\+\s+(\S+)\s+\d{1,4}-\d{1,2}-\d{1,2}\s+\d{1,2}:\d{1,2}:\d{1,2}(\.\d+)?\s+(\+|-)\d{4}/A' |
|---|
HUNK
用于搜索差异部分的正则表达式
| 值 | '/@@ -(\d+)(,(\d+))?\s+\+(\d+)(,(\d+))?\s+@@($)/A' |
|---|
SPLIT
用于分隔行的正则表达式
| 值 | '/(\r\n)|(\r)|(\n)/' |
|---|
属性
sources
源文件
| 自 |
3.0.0 |
|---|
类型
array<string|int, mixed>
destinations
目标文件
| 自 |
3.0.0 |
|---|
类型
array<string|int, mixed>
removals
删除文件
| 自 |
3.0.0 |
|---|
类型
array<string|int, mixed>
patches
patches
| 自 |
3.0.0 |
|---|
类型
array<string|int, mixed>
instance
此类的实例
| 自 |
3.0.0 |
|---|
类型
array<string|int, mixed>