Documentation

rex_null_package
in package
implements rex_package_interface Uses rex_singleton_trait

AbstractYes

Represents a null package.

Instances of this class are returned by rex_package::get() for non-existing packages. Thereby it is safe to call rex_package::get(...)->isAvailable() and isInstalled(). Other methods should not be called on null-packages since they do not return useful values. Some methods like getPath() throw exceptions.

Tags
author

gharlan

Table of Contents

Interfaces

rex_package_interface
Interface for packages.

Methods

getAddon()  : rex_null_addon
Returns the related Addon.
getAssetsPath()  : non-empty-string
Returns the assets path.
getAssetsUrl()  : non-empty-string
Returns the assets url.
getAuthor()  : string|null
Returns the author.
getCachePath()  : non-empty-string
Returns the cache path.
getConfig()  : mixed
getDataPath()  : non-empty-string
Returns the data path.
getName()  : non-empty-string
Returns the name of the package.
getPackageId()  : non-empty-string|null
Returns the package ID.
getPath()  : non-empty-string
Returns the base path.
getProperty()  : mixed
Returns a property.
getSupportPage()  : string|null
Returns the supportpage.
getVersion()  : string
Returns the version.
hasConfig()  : bool
hasProperty()  : bool
Returns if a property is set.
i18n()  : non-empty-string
Adds the package prefix to the given key and returns the translation for it.
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.
isSystemPackage()  : bool
Returns if it is a system package.
removeConfig()  : bool
removeProperty()  : void
Removes a property.
setConfig()  : bool
setProperty()  : void
Sets a property.

Methods

getAssetsPath()

Returns the assets path.

public getAssetsPath([mixed $file = '' ]) : non-empty-string
Parameters
$file : mixed = ''

File

Return values
non-empty-string

getAssetsUrl()

Returns the assets url.

public getAssetsUrl([mixed $file = '' ]) : non-empty-string
Parameters
$file : mixed = ''

File

Return values
non-empty-string

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

getCachePath()

Returns the cache path.

public getCachePath([mixed $file = '' ]) : non-empty-string
Parameters
$file : mixed = ''

File

Return values
non-empty-string

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

getDataPath()

Returns the data path.

public getDataPath([mixed $file = '' ]) : non-empty-string
Parameters
$file : mixed = ''

File

Return values
non-empty-string

getName()

Returns the name of the package.

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

Name

getPackageId()

Returns the package ID.

public getPackageId() : non-empty-string|null
Return values
non-empty-string|null

getPath()

Returns the base path.

public getPath([mixed $file = '' ]) : non-empty-string
Parameters
$file : mixed = ''

File

Return values
non-empty-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

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

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

i18n()

Adds the package prefix to the given key and returns the translation for it.

public i18n(mixed $key, mixed ...$replacements) : non-empty-string
Parameters
$key : mixed

Key

$replacements : mixed

A arbritary number of strings used for interpolating within the resolved messag

Return values
non-empty-string —

Translation for the key

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

isSystemPackage()

Returns if it is a system package.

public isSystemPackage() : bool
Return values
bool

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

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


        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results