Joomla CMS  3.10.11 (avec JPlatform 13.1 inclus)
Documentation des API du CMS Joomla en version 3.10.11 et du framework Joomla Platform intégré
Référence de la classe Patcher

Fonctions membres publiques

 reset ()
 
 apply ()
 
 addFile ($filename, $root=JPATH_ROOT, $strip=0)
 
 add ($udiff, $root=JPATH_ROOT, $strip=0)
 

Fonctions membres publiques statiques

static getInstance ()
 

Champs de données

const 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'
 
const 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'
 
const HUNK = '/@@ -(\\d+)(,(\\d+))?\\s+\\+(\\d+)(,(\\d+))?\\s+@@($)/A'
 
const SPLIT = '/(\r\n)|(\r)|(\n)/'
 

Fonctions membres protégées

 __construct ()
 
 applyHunk (&$lines, $src, $dst, $srcLine, $srcSize, $dstLine, $dstSize)
 
getSource ($src)
 
getDestination ($dst, $src)
 

Fonctions membres protégées statiques

static splitLines ($data)
 
static findHeader (&$lines, &$src, &$dst)
 
static findHunk (&$lines, &$srcLine, &$srcSize, &$dstLine, &$dstSize)
 

Attributs protégés

 $sources = array()
 
 $destinations = array()
 
 $removals = array()
 
 $patches = array()
 

Attributs protégés statiques

static $instance
 

Description détaillée

Documentation des constructeurs et destructeur

◆ __construct()

__construct ( )
protected

Constructor

The constructor is protected to force the use of Patcher::getInstance()

Depuis
1.0

Documentation des fonctions membres

◆ add()

add (   $udiff,
  $root = JPATH_ROOT,
  $strip = 0 
)

Add a unified diff string to the patcher

Paramètres
string$udiffUnified diff input string
string$rootThe files root path
integer$stripThe number of '/' to strip
Renvoie
Patcher $this for chaining
Depuis
1.0

Références $root, et DIRECTORY_SEPARATOR.

Référencé par Patcher\addFile().

◆ addFile()

addFile (   $filename,
  $root = JPATH_ROOT,
  $strip = 0 
)

Add a unified diff file to the patcher

Paramètres
string$filenamePath to the unified diff file
string$rootThe files root path
integer$stripThe number of '/' to strip
Renvoie
Patcher $this for chaining
Depuis
1.0

Références $root, et Patcher\add().

◆ apply()

apply ( )

Apply the patches

Renvoie
integer The number of files patched
Depuis
1.0
Exceptions

Références $content, $file, Patcher\applyHunk(), File\delete(), null, et File\write().

◆ applyHunk()

applyHunk ( $lines,
  $src,
  $dst,
  $srcLine,
  $srcSize,
  $dstLine,
  $dstSize 
)
protected

Apply the patch

Paramètres
array$linesThe udiff array of lines
string$srcThe source file
string$dstThe destination file
string$srcLineThe beginning of the patch for the source file
string$srcSizeThe size of the patch for the source file
string$dstLineThe beginning of the patch for the destination file
string$dstSizeThe size of the patch for the destination file
Renvoie
void
Depuis
1.0
Exceptions

Références elseif, Patcher\getDestination(), Patcher\getSource(), et Path\removeRoot().

Référencé par Patcher\apply().

◆ findHeader()

static findHeader ( $lines,
$src,
$dst 
)
staticprotected

Find the diff header

The internal array pointer of $lines is on the next line after the finding

Paramètres
array$linesThe udiff array of lines
string$srcThe source file
string$dstThe destination file
Renvoie
boolean TRUE in case of success, FALSE in case of failure
Depuis
1.0
Exceptions

◆ findHunk()

static findHunk ( $lines,
$srcLine,
$srcSize,
$dstLine,
$dstSize 
)
staticprotected

Find the next hunk of difference

The internal array pointer of $lines is on the next line after the finding

Paramètres
array$linesThe udiff array of lines
string$srcLineThe beginning of the patch for the source file
string$srcSizeThe size of the patch for the source file
string$dstLineThe beginning of the patch for the destination file
string$dstSizeThe size of the patch for the destination file
Renvoie
boolean TRUE in case of success, false in case of failure
Depuis
1.0
Exceptions

◆ getDestination()

& getDestination (   $dst,
  $src 
)
protected

Get the lines of a destination file

Paramètres
string$dstThe path of a destination file
string$srcThe path of a source file
Renvoie
array The lines of the destination file
Depuis
1.0

Références Patcher\getSource().

Référencé par Patcher\applyHunk().

◆ getInstance()

static getInstance ( )
static

Method to get a patcher

Renvoie
Patcher an instance of the patcher
Depuis
1.0

◆ getSource()

& getSource (   $src)
protected

Get the lines of a source file

Paramètres
string$srcThe path of a file
Renvoie
array The lines of the source file
Depuis
1.0

Références null.

Référencé par Patcher\applyHunk(), et Patcher\getDestination().

◆ reset()

reset ( )

Reset the patcher

Renvoie
Patcher This object for chaining
Depuis
1.0

◆ splitLines()

static splitLines (   $data)
staticprotected

Separate CR or CRLF lines

Paramètres
string$dataInput string
Renvoie
array The lines of the input destination file
Depuis
1.0

Références $data.

Documentation des champs

◆ $destinations

$destinations = array()
protected

◆ $instance

$instance
staticprotected

◆ $patches

$patches = array()
protected

◆ $removals

$removals = array()
protected

◆ $sources

$sources = array()
protected

◆ DST_FILE

const 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

const HUNK = '/@@ -(\\d+)(,(\\d+))?\\s+\\+(\\d+)(,(\\d+))?\\s+@@($)/A'

◆ SPLIT

const SPLIT = '/(\r\n)|(\r)|(\n)/'

◆ SRC_FILE

const 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'

La documentation de cette classe a été générée à partir du fichier suivant :