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>