Documentation

rex_package
in package
implements rex_package_interface

AbstractYes

Abstract base class for packages.

Tags
author

gharlan

Table of Contents

Interfaces

rex_package_interface
Interface for packages.

Constants

FILE_BOOT  = 'boot.php'
FILE_INSTALL  = 'install.php'
FILE_INSTALL_SQL  = 'install.sql'
FILE_PACKAGE  = 'package.yml'
FILE_UNINSTALL  = 'uninstall.php'
FILE_UNINSTALL_SQL  = 'uninstall.sql'
FILE_UPDATE  = 'update.php'

Methods

__construct()  : mixed
boot()  : void
clearCache()  : void
Clears the cache of the package.
enlist()  : void
exists()  : bool
Returns if the package exists.
get()  : rex_package_interface
Returns the package (addon or plugin) by the given package id.
getAuthor()  : string|null
Returns the author.
getAvailablePackages()  : array<string, self>
Returns the available packages.
getConfig()  : mixed
getInstalledPackages()  : array<string, self>
Returns the installed packages.
getName()  : non-empty-string
Returns the name of the package.
getPackageId()  : string
Returns the package ID.
getProperty()  : mixed
Returns a property.
getRegisteredPackages()  : array<string, self>
Returns the registered packages.
getSetupPackages()  : array<string, self>
Returns the setup packages.
getSupportPage()  : string|null
Returns the supportpage.
getSystemPackages()  : array<string, self>
Returns the system packages.
getVersion()  : string
Returns the version.
hasConfig()  : bool
hasProperty()  : bool
Returns if a property is set.
includeFile()  : mixed
Includes a file in the package context.
isAvailable()  : bool
Returns if the package is available (activated and installed).
isInstalled()  : bool
Returns if the package is installed.
loadProperties()  : void
Loads the properties of package.yml.
removeConfig()  : bool
removeProperty()  : void
Removes a property.
require()  : self
Returns the package (addon or plugin) by the given package id.
setConfig()  : bool
setProperty()  : void
Sets a property.
splitId()  : array{: string, : ?string}
Splits the package id into a tuple of addon id and plugin id (if existing).

Constants

FILE_BOOT

public mixed FILE_BOOT = 'boot.php'

FILE_INSTALL

public mixed FILE_INSTALL = 'install.php'

FILE_INSTALL_SQL

public mixed FILE_INSTALL_SQL = 'install.sql'

FILE_PACKAGE

public mixed FILE_PACKAGE = 'package.yml'

FILE_UNINSTALL

public mixed FILE_UNINSTALL = 'uninstall.php'

FILE_UNINSTALL_SQL

public mixed FILE_UNINSTALL_SQL = 'uninstall.sql'

FILE_UPDATE

public mixed FILE_UPDATE = 'update.php'

Methods

__construct()

public __construct(non-empty-string $name) : mixed
Parameters
$name : non-empty-string

Name

exists()

Returns if the package exists.

public static exists(string $packageId) : bool
Parameters
$packageId : string

Package ID

Return values
bool

get()

Returns the package (addon or plugin) by the given package id.

public static get(string $packageId) : rex_package_interface
Parameters
$packageId : string

Package ID

Tags
throws
InvalidArgumentException
Return values
rex_package_interface

If the package exists, a rex_package is returned, otherwise a rex_null_package

getAuthor()

Returns the author.

public getAuthor([mixed $default = null ]) : string|null
Parameters
$default : mixed = null

Default value, will be returned if the property isn't set

Return values
string|null

getAvailablePackages()

Returns the available packages.

public static getAvailablePackages() : array<string, self>
Return values
array<string, self>

getConfig()

public getConfig([mixed $key = null ][, mixed $default = null ]) : mixed
Parameters
$key : mixed = null

The associated key

$default : mixed = null

Default return value if no associated-value can be found

Return values
mixed

the value for $key or $default if $key cannot be found in the given $namespace

getInstalledPackages()

Returns the installed packages.

public static getInstalledPackages() : array<string, self>
Return values
array<string, self>

getName()

Returns the name of the package.

public getName() : non-empty-string
Return values
non-empty-string

Name

getPackageId()

Returns the package ID.

public abstract getPackageId() : string
Return values
string

getProperty()

Returns a property.

public getProperty(mixed $key[, mixed $default = null ]) : mixed
Parameters
$key : mixed

Key of the property

$default : mixed = null

Default value, will be returned if the property isn't set

getRegisteredPackages()

Returns the registered packages.

public static getRegisteredPackages() : array<string, self>
Return values
array<string, self>

getSetupPackages()

Returns the setup packages.

public static getSetupPackages() : array<string, self>
Return values
array<string, self>

getSupportPage()

Returns the supportpage.

public getSupportPage([mixed $default = null ]) : string|null
Parameters
$default : mixed = null

Default value, will be returned if the property isn't set

Return values
string|null

getSystemPackages()

Returns the system packages.

public static getSystemPackages() : array<string, self>
Return values
array<string, self>

getVersion()

Returns the version.

public getVersion([mixed $format = null ]) : string
Parameters
$format : mixed = null

See

Return values
string

hasConfig()

public hasConfig([mixed $key = null ]) : bool
Parameters
$key : mixed = null

The associated key

Return values
bool

hasProperty()

Returns if a property is set.

public hasProperty(mixed $key) : bool
Parameters
$key : mixed

Key of the property

Return values
bool

includeFile()

Includes a file in the package context.

public includeFile(mixed $file[, array<string|int, mixed> $context = [] ]) : mixed
Parameters
$file : mixed

Filename

$context : array<string|int, mixed> = []

Context values, available as variables in given file

isAvailable()

Returns if the package is available (activated and installed).

public isAvailable() : bool
Return values
bool

isInstalled()

Returns if the package is installed.

public isInstalled() : bool
Return values
bool

loadProperties()

Loads the properties of package.yml.

public loadProperties([bool $force = false ]) : void
Parameters
$force : bool = false

removeConfig()

public removeConfig(mixed $key) : bool
Parameters
$key : mixed

The associated key

Return values
bool

removeProperty()

Removes a property.

public removeProperty(mixed $key) : void
Parameters
$key : mixed

Key of the property

require()

Returns the package (addon or plugin) by the given package id.

public static require(string $packageId) : self
Parameters
$packageId : string
Tags
throws
RuntimeException

if the package does not exist

Return values
self

setConfig()

public setConfig(mixed $key[, mixed $value = null ]) : bool
Parameters
$key : mixed

The associated key or an associative array of key/value pairs

$value : mixed = null

The value to save

Return values
bool

TRUE when an existing value was overridden, otherwise FALSE

setProperty()

Sets a property.

public setProperty(mixed $key, mixed $value) : void
Parameters
$key : mixed

Key of the property

$value : mixed

New value for the property

splitId()

Splits the package id into a tuple of addon id and plugin id (if existing).

public static splitId(string $packageId) : array{: string, : ?string}
Parameters
$packageId : string
Return values
array{: string, : ?string}

        
On this page

Search results