Elgg
Version master
|
Public Member Functions | |
__set ($name, $value) | |
__get ($name) | |
setFilename (string $filename) | |
Set the filename of this file. More... | |
getFilename () | |
Return the filename. More... | |
getFilenameOnFilestore () | |
Return the filename of this file as it is/will be stored on the filestore, which may be different to the filename. More... | |
getMimeType () | |
Get the mime type of the file. More... | |
setMimeType (string $mimetype) | |
Set the mime type of the file. More... | |
getSimpleType () | |
Get the simple type of the file. More... | |
open (string $mode) | |
Open the file with the given mode. More... | |
write (string $data) | |
Write data. More... | |
read (int $length, int $offset=0) | |
Read data. More... | |
grabFile () | |
Gets the full contents of this file. More... | |
close () | |
Close the file and commit changes. More... | |
delete (bool $follow_symlinks=true) | |
Delete this file. More... | |
seek (int $position) | |
Seek a position in the file. More... | |
tell () | |
Return the current position of the file. More... | |
setModifiedTime () | |
Updates modification time of the file and clears stats cache for the file. More... | |
getModifiedTime () | |
Returns file modification time. More... | |
getSize () | |
Return the size of the file in bytes. More... | |
eof () | |
Return a boolean value whether the file handle is at the end of the file. More... | |
exists () | |
Returns if the file exists. More... | |
transfer (int $owner_guid, string $filename=null) | |
Transfer a file to a new owner and sets a new filename, copies file contents to a new location. More... | |
acceptUploadedFile (UploadedFile $upload) | |
Writes contents of the uploaded file to an instance of ElggFile. More... | |
__sleep () | |
Get property names to serialize. More... | |
canDownload (int $user_guid=0, bool $default=true) | |
Checks the download permissions for the file. More... | |
getDownloadURL (bool $use_cookie=true, string $expires= '+2 hours') | |
Returns file's download URL. More... | |
getInlineURL (bool $use_cookie=false, string $expires= '') | |
Returns file's URL for inline display Suitable for displaying cacheable resources, such as user avatars. More... | |
![]() | |
getType () | |
{} More... | |
getDisplayName () | |
{} More... | |
setDisplayName (string $display_name) | |
{} More... | |
![]() | |
__construct (stdClass $row=null) | |
Create a new entity. More... | |
__clone () | |
Clone an entity. More... | |
__set ($name, $value) | |
Set an attribute or metadata value for this entity. More... | |
getOriginalAttributes () | |
Get the original values of attribute(s) that have been modified since the entity was persisted. More... | |
__get ($name) | |
Get an attribute or metadata value. More... | |
getDisplayName () | |
Get the entity's display name. More... | |
setDisplayName (string $display_name) | |
Sets the title or name of this entity. More... | |
getMetadata (string $name) | |
Return the value of a piece of metadata. More... | |
getAllMetadata () | |
Get all entity metadata. More... | |
setMetadata (string $name, $value, string $value_type= '', bool $multiple=false) | |
Set metadata on this entity. More... | |
deleteMetadata (string $name=null) | |
Deletes all metadata on this object (metadata.entity_guid = $this->guid). More... | |
getVolatileData (string $name) | |
Get a piece of volatile (non-persisted) data on this entity. More... | |
setVolatileData (string $name, $value) | |
Set a piece of volatile (non-persisted) data on this entity. More... | |
addRelationship (int $guid_two, string $relationship) | |
Add a relationship between this an another entity. More... | |
hasRelationship (int $guid_two, string $relationship) | |
Check if this entity has a relationship with another entity. More... | |
getRelationship (int $guid_two, string $relationship) | |
Return the relationship if this entity has a relationship with another entity. More... | |
getEntitiesFromRelationship (array $options=[]) | |
Gets an array of entities with a relationship to this entity. More... | |
countEntitiesFromRelationship (string $relationship, bool $inverse_relationship=false) | |
Gets the number of entities from a specific relationship type. More... | |
removeRelationship (int $guid_two, string $relationship) | |
Remove a relationship. More... | |
removeAllRelationships (string $relationship= '', bool $inverse_relationship=false) | |
Remove all relationships to or from this entity. More... | |
removeAllRelatedRiverItems () | |
Removes all river items related to this entity. More... | |
deleteAnnotations (string $name=null) | |
Deletes all annotations on this object (annotations.entity_guid = $this->guid). More... | |
deleteOwnedAnnotations (string $name=null) | |
Deletes all annotations owned by this object (annotations.owner_guid = $this->guid). More... | |
disableAnnotations (string $name=null) | |
Disables annotations for this entity, optionally based on name. More... | |
enableAnnotations (string $name=null) | |
Enables annotations for this entity, optionally based on name. More... | |
annotate ($name, $value, $access_id=ACCESS_PRIVATE, $owner_guid=0, $value_type= '') | |
Adds an annotation to an entity. More... | |
getAnnotations (array $options=[]) | |
Gets an array of annotations. More... | |
countAnnotations (string $name= '') | |
Count annotations. More... | |
getAnnotationsAvg (string $name) | |
Get the average of an integer type annotation. More... | |
getAnnotationsSum (string $name) | |
Get the sum of integer type annotations of a given name. More... | |
getAnnotationsMin (string $name) | |
Get the minimum of integer type annotations of given name. More... | |
getAnnotationsMax (string $name) | |
Get the maximum of integer type annotations of a given name. More... | |
countComments () | |
Count the number of comments attached to this entity. More... | |
getOwnedAccessCollections (array $options=[]) | |
Returns the ACLs owned by the entity. More... | |
getOwnedAccessCollection (string $subtype) | |
Returns the first ACL owned by the entity with a given subtype. More... | |
hasAccess (int $user_guid=0) | |
Check if the given user has access to this entity. More... | |
canEdit (int $user_guid=0) | |
Can a user edit this entity? More... | |
canDelete (int $user_guid=0) | |
Can a user delete this entity? More... | |
canWriteToContainer (int $user_guid=0, string $type= '', string $subtype= '') | |
Can a user add an entity to this container. More... | |
canComment (int $user_guid=0) | |
Can a user comment on an entity? More... | |
canAnnotate (int $user_guid=0, string $annotation_name= '') | |
Can a user annotate an entity? More... | |
getGUID () | |
Returns the guid. More... | |
getType () | |
Returns the entity type. More... | |
setSubtype (string $subtype) | |
Set the subtype of the entity. More... | |
getSubtype () | |
Get the entity subtype. More... | |
getOwnerGUID () | |
Get the guid of the entity's owner. More... | |
getOwnerEntity () | |
Gets the that owns this entity. More... | |
setContainerGUID (int $container_guid) | |
Set the container for this object. More... | |
getContainerGUID () | |
Gets the container GUID for this entity. More... | |
getContainerEntity () | |
Get the container entity for this object. More... | |
getTimeUpdated () | |
Returns the UNIX epoch time that this entity was last updated. More... | |
getURL () | |
Gets the URL for this entity. More... | |
saveIconFromUploadedFile (string $input_name, string $type= 'icon', array $coords=[]) | |
Saves icons using an uploaded file as the source. More... | |
saveIconFromLocalFile (string $filename, string $type= 'icon', array $coords=[]) | |
Saves icons using a local file as the source. More... | |
saveIconFromElggFile (\ElggFile $file, string $type= 'icon', array $coords=[]) | |
Saves icons using a file located in the data store as the source. More... | |
getIcon (string $size, string $type= 'icon') | |
Returns entity icon as an ElggIcon object The icon file may or may not exist on filestore. More... | |
deleteIcon (string $type= 'icon') | |
Removes all icon files and metadata for the passed type of icon. More... | |
getIconLastChange (string $size, string $type= 'icon') | |
Returns the timestamp of when the icon was changed. More... | |
hasIcon (string $size, string $type= 'icon') | |
Returns if the entity has an icon of the passed type. More... | |
getIconURL (string|array $params=[]) | |
Get the URL for this entity's icon. More... | |
save () | |
disable (string $reason= '', bool $recursive=true) | |
Disable this entity. More... | |
enable (bool $recursive=true) | |
Enable the entity. More... | |
isEnabled () | |
Is this entity enabled? More... | |
delete (bool $recursive=true) | |
Deletes the entity. More... | |
toObject (array $params=[]) | |
Export an entity. More... | |
setLatLong (float $lat, float $long) | |
Set latitude and longitude metadata tags for a given entity. More... | |
getLatitude () | |
Return the entity's latitude. More... | |
getLongitude () | |
Return the entity's longitude. More... | |
getSystemLogID () | |
{} More... | |
getObjectFromID (int $id) | |
For a given ID, return the object associated with it. More... | |
getTags ($tag_names=null) | |
Returns tags for this entity. More... | |
deleteAccessCollectionMemberships () | |
Remove the membership of all access collections for this entity (if the entity is a user) More... | |
deleteOwnedAccessCollections () | |
Remove all access collections owned by this entity. More... | |
updateLastAction (int $posted=null) | |
Update the last_action column in the entities table. More... | |
disableCaching () | |
Disable runtime caching for entity. More... | |
enableCaching () | |
Enable runtime caching for entity. More... | |
isCacheable () | |
Is entity cacheable in the runtime cache. More... | |
cache (bool $persist=true) | |
Cache the entity in a session and persisted caches. More... | |
invalidateCache () | |
Invalidate cache for entity. More... | |
hasCapability (string $capability) | |
Checks a specific capability is enabled for the entity type/subtype. More... | |
![]() | |
__isset ($name) | |
Test if property is set either as an attribute or metadata. More... | |
__unset ($name) | |
Unset a property from metadata or attribute. More... | |
getURL () | |
Get a URL for this object. More... | |
save () | |
Save this data to the appropriate database table. More... | |
delete () | |
Delete this data. More... | |
getTimeCreated () | |
Returns the UNIX epoch time that this entity was created. More... | |
toObject (array $params=[]) | |
Get a plain old object copy for public consumption. More... | |
getSystemLogID () | |
Return an identification for the object for storage in the system log. More... | |
getType () | |
Return the type of the object - eg. More... | |
getSubtype () | |
Return a subtype. More... | |
getObjectFromID (int $id) | |
For a given ID, return the object associated with it. More... | |
rewind () | |
Iterator interface. More... | |
current () | |
Iterator interface. More... | |
key () | |
Iterator interface. More... | |
next () | |
Iterator interface. More... | |
valid () | |
Iterator interface. More... | |
offsetSet ($offset, $value) | |
Array access interface. More... | |
offsetGet ($offset) | |
Array access interface. More... | |
offsetUnset ($offset) | |
Array access interface. More... | |
offsetExists ($offset) | |
Array access interface. More... | |
getID () | |
{Get unique item identifier within a collection.
| |
getPriority () | |
{Get priority (weight) of the item within a collection.
| |
__serialize () | |
Called during serialization. More... | |
__unserialize (array $data) | |
Called during unserialization. More... | |
![]() | |
getIconURL (array $params) | |
Returns a URL of the icon. More... | |
Protected Member Functions | |
initializeAttributes () | |
Set subtype to 'file'. More... | |
getFilestore () | |
Return the system filestore based on dataroot. More... | |
![]() | |
prepareObject (\Elgg\Export\Entity $object) | |
{} More... | |
![]() | |
initializeAttributes () | |
Initialize the attributes array. More... | |
setTempMetadata (string $name, $value, bool $multiple=false) | |
Set temp metadata on this entity. More... | |
create () | |
Create a new entry in the entities table. More... | |
update () | |
Update the entity in the database. More... | |
load (stdClass $row) | |
Loads attributes from the entities table into the object. More... | |
prepareObject (\Elgg\Export\Entity $object) | |
Prepare an object copy for toObject() More... | |
![]() | |
initializeAttributes () | |
Initialize the attributes array. More... | |
getDatabase () | |
Provides a pointer to the database object. More... | |
Additional Inherited Members | |
![]() | |
const | PRIMARY_ATTR_NAMES |
![]() | |
const | INTEGER_ATTR_NAMES |
$temp_metadata = [] | |
$temp_annotations = [] | |
$volatile = [] | |
$orig_attributes = [] | |
$_is_cacheable = true | |
$_cached_metadata | |
![]() | |
$attributes = [] | |
$valid = false | |
Definition at line 32 of file ElggFile.php.
ElggFile::__get | ( | $name | ) |
Definition at line 68 of file ElggFile.php.
ElggFile::__set | ( | $name, | |
$value | |||
) |
Definition at line 54 of file ElggFile.php.
ElggFile::__sleep | ( | ) |
ElggFile::acceptUploadedFile | ( | UploadedFile | $upload | ) |
Writes contents of the uploaded file to an instance of ElggFile.
UploadedFile | $upload | Uploaded file object |
Definition at line 385 of file ElggFile.php.
ElggFile::canDownload | ( | int | $user_guid = 0 , |
bool | $default = true |
||
) |
Checks the download permissions for the file.
int | $user_guid | GUID of the user (defaults to logged in user) |
bool | $default | Default permission |
Definition at line 467 of file ElggFile.php.
ElggFile::close | ( | ) |
ElggFile::delete | ( | bool | $follow_symlinks = true | ) |
Delete this file.
bool | $follow_symlinks | If true, will also delete the target file if the current file is a symlink |
Definition at line 240 of file ElggFile.php.
ElggFile::eof | ( | ) |
Return a boolean value whether the file handle is at the end of the file.
Definition at line 312 of file ElggFile.php.
ElggFile::exists | ( | ) |
ElggFile::getDownloadURL | ( | bool | $use_cookie = true , |
string | $expires = '+2 hours' |
||
) |
Returns file's download URL.
bool | $use_cookie | Limit URL validity to current session only |
string | $expires | URL expiration, as a string suitable for strtotime() |
Definition at line 481 of file ElggFile.php.
ElggFile::getFilename | ( | ) |
Return the filename.
This filename will be sanitized to prevent path traversal
Definition at line 96 of file ElggFile.php.
ElggFile::getFilenameOnFilestore | ( | ) |
Return the filename of this file as it is/will be stored on the filestore, which may be different to the filename.
Definition at line 111 of file ElggFile.php.
|
protected |
ElggFile::getInlineURL | ( | bool | $use_cookie = false , |
string | $expires = '' |
||
) |
Returns file's URL for inline display Suitable for displaying cacheable resources, such as user avatars.
bool | $use_cookie | Limit URL validity to current session only |
string | $expires | URL expiration, as a string suitable for strtotime() |
Definition at line 510 of file ElggFile.php.
ElggFile::getMimeType | ( | ) |
Get the mime type of the file.
Returns mimetype metadata value if set, otherwise attempts to detect it.
Definition at line 121 of file ElggFile.php.
ElggFile::getModifiedTime | ( | ) |
ElggFile::getSimpleType | ( | ) |
Get the simple type of the file.
Returns simpletype metadata value if set, otherwise parses it from mimetype
Definition at line 153 of file ElggFile.php.
ElggFile::getSize | ( | ) |
Return the size of the file in bytes.
Definition at line 303 of file ElggFile.php.
ElggFile::grabFile | ( | ) |
Gets the full contents of this file.
Definition at line 214 of file ElggFile.php.
|
protected |
ElggFile::open | ( | string | $mode | ) |
Open the file with the given mode.
string | $mode | Either read/write/append |
IOException | |
Definition at line 171 of file ElggFile.php.
ElggFile::read | ( | int | $length, |
int | $offset = 0 |
||
) |
Read data.
int | $length | Amount to read. |
int | $offset | The offset to start from. |
Definition at line 205 of file ElggFile.php.
ElggFile::seek | ( | int | $position | ) |
Seek a position in the file.
int | $position | Position in bytes |
Definition at line 257 of file ElggFile.php.
ElggFile::setFilename | ( | string | $filename | ) |
Set the filename of this file.
This filename will be sanitized to prevent path traversal
string | $filename | The filename |
Definition at line 85 of file ElggFile.php.
ElggFile::setMimeType | ( | string | $mimetype | ) |
Set the mime type of the file.
string | $mimetype | The mimetype |
Definition at line 143 of file ElggFile.php.
ElggFile::setModifiedTime | ( | ) |
Updates modification time of the file and clears stats cache for the file.
Definition at line 275 of file ElggFile.php.
ElggFile::tell | ( | ) |
Return the current position of the file.
Definition at line 266 of file ElggFile.php.
ElggFile::transfer | ( | int | $owner_guid, |
string | $filename = null |
||
) |
Transfer a file to a new owner and sets a new filename, copies file contents to a new location.
This is an alternative to using rename() which fails to move files to a non-existent directory under new owner's filestore directory
int | $owner_guid | New owner's guid |
string | $filename | New filename (uses old filename if not set) |
Definition at line 346 of file ElggFile.php.
ElggFile::write | ( | string | $data | ) |
Write data.
string | $data | The data |
Definition at line 193 of file ElggFile.php.