CollectionAdapter
Extends UpdateAdapterCollection Update Adapter Class
| since |
1.7.0 |
|---|---|
| package |
Joomla CMS |
Methods
__construct
Constructor
__construct(\Joomla\CMS\Updater\Updater parent, \Joomla\Database\DatabaseDriver db, mixed||string|int options = []) :
| since |
1.6 |
|---|
Arguments
- parent
UpdaterParent object- db
DatabaseDriverDatabase object- options
array<string|int, mixed>Configuration Options
Response
mixed
_endElement
Closing an XML element Note: This is a protected function though has to be exposed externally as a callback
_endElement( parser, name) :
| since |
1.7.0 |
|---|
Arguments
- parser
objectParser object- name
stringName of the element closing
Response
void
_getLastTag
Gets the reference to the last tag
_getLastTag() :
| since |
1.7.0 |
|---|
Response
object
_getParent
Get the parent tag
_getParent() :
| since |
1.7.0 |
|---|
Response
stringparent
_getStackLocation
Gets the reference to the current direct parent
_getStackLocation() :
| since |
1.7.0 |
|---|
Response
string
_startElement
Opening an XML element
_startElement( parser, name, mixed||string|int attrs = []) :
| since |
1.7.0 |
|---|
Arguments
- parser
objectParser object- name
stringName of element that is opened- attrs
array<string|int, mixed>Array of attributes for the element
Response
void
def
Sets a default value if not already assigned
def( property, default = null) :
| since |
1.7.0 |
|---|---|
| deprecated |
4.3.0 will be removed in 7.0 Defining dynamic properties should not be used anymore |
Arguments
- property
stringThe name of the property.- default
mixedThe default value.
Response
mixed
findUpdate
Finds an update
findUpdate(mixed||string|int options) : array|bool
| since |
1.7.0 |
|---|
Arguments
- options
array<string|int, mixed>Options to use: update_site_id: the unique ID of the update site to look at
Response
array<string|int, mixed>|boolUpdate_sites and updates discovered. False on failure
get
Returns a property of the object or the default value if the property is not set.
get( property, default = null) :
| since |
1.7.0 |
|---|---|
| see | CMSObject::getProperties() |
| deprecated |
4.3.0 will be removed in 7.0 Create a proper getter function for the property |
Arguments
- property
stringThe name of the property.- default
mixedThe default value.
Response
mixedThe value of the property.
getProperties
Returns an associative array of object properties.
getProperties( public = true) : mixed||string|int
| since |
1.7.0 |
|---|---|
| see | CMSObject::get() |
| deprecated |
4.3.0 will be removed in 7.0 Create a proper getter function for the property |
Arguments
- public
boolIf true, returns only the public properties.
Response
array<string|int, mixed>
getUpdateSiteName
Get the name of an update site. This is used in logging.
getUpdateSiteName( updateSiteId) :
Arguments
- updateSiteId
intThe numeric ID of the update site
Response
stringThe name of the update site or an empty string if it's not found
getUpdateSiteResponse
Try to get the raw HTTP response from the update site, hopefully containing the update XML.
getUpdateSiteResponse(mixed||string|int options = []) : \Joomla\Http\Response|bool
| throws |
|
|---|
Arguments
- options
array<string|int, mixed>The update options, see findUpdate() in children classes
Response
Response|boolFalse if we can't connect to the site, HTTP Response object otherwise
set
Modifies a property of the object, creating it if it does not already exist.
set( property, value = null) :
| since |
1.7.0 |
|---|---|
| deprecated |
4.3.0 will be removed in 7.0 Create a proper setter function for the property |
Arguments
- property
stringThe name of the property.- value
mixedThe value of the property to set.
Response
mixedPrevious value of the property.
setProperties
Set the object properties based on a named array/hash.
setProperties( properties) :
| since |
1.7.0 |
|---|---|
| see | CMSObject::set() |
| deprecated |
4.3.0 will be removed in 7.0 Create a proper setter function for the property |
Arguments
- properties
mixedEither an associative array or another object.
Response
bool
toggleUpdateSite
Toggles the enabled status of an update site. Update sites are disabled before getting the update information from their URL and enabled afterwards. If the URL fetch fails with a PHP fatal error (e.g. timeout) the faulty update site will remain disabled the next time we attempt to load the update information.
toggleUpdateSite( updateSiteId, enabled = true) :
Arguments
- updateSiteId
intThe numeric ID of the update site to enable/disable- enabled
boolEnable the site when true, disable it when false
Response
void
Properties
parent
Tree of objects
| since |
1.7.0 |
|---|
Type(s)
array<string|int, mixed>
xmlParser
Resource handle for the XML Parser
| since |
3.0.0 |
|---|
Type(s)
XMLParser
stack
Element call stack
| since |
3.0.0 |
|---|
Type(s)
array<string|int, mixed>
updateSiteId
ID of update site
| since |
3.0.0 |
|---|
Type(s)
int
updatecols
Columns in the extensions table to be updated
| since |
3.0.0 |
|---|
Type(s)
array<string|int, mixed>
appendExtension
Should we try appending a .xml extension to the update site's URL?
Type(s)
bool
updateSiteName
The name of the update site (used in logging)
Type(s)
string
_url
The update site URL from which we will get the update information
Type(s)
string
minimum_stability
The minimum stability required for updates to be taken into account. The possible values are: 0 dev Development snapshots, nightly builds, pre-release versions and so on 1 alpha Alpha versions (work in progress, things are likely to be broken) 2 beta Beta versions (major functionality in place, show-stopper bugs are likely to be present) 3 rc Release Candidate versions (almost stable, minor bugs might be present) 4 stable Stable versions (production quality code)
db
Database
| since |
1.6 |
|---|
Type(s)
DatabaseDriver
base
Root of the tree
| since |
1.7.0 |
|---|
Type(s)
object
pop_parent
Used to control if an item has a child or not
| since |
1.7.0 |
|---|
Type(s)
int
update_sites
A list of discovered update sites
Type(s)
array<string|int, mixed>
updates
A list of discovered updates
Type(s)
array<string|int, mixed>