Manual:LocalFile.php

MediaWiki file: LocalFile.php
Location:	includes/filerepo/file/
Source code:	master • 1.43.0 • 1.42.4 • 1.39.11
Classes:	LocalFile

LocalFile.php contains the class LocalFile, which extends File , to represent a local file in the wiki's own database. It provides methods to retrieve paths, generate image thumbnails and to let users upload files.

See Manual:File.php for general advice on generating file objects.

Methods

Excluding protected, private and internal methods:

• Create a LocalFile instance - to be called from inside a Repo class
  • newFromTitle(), newFromRow(), newFromKey()
• Render
  • prerenderThumbnails()
• Upload
  • upload() - Upload a file and record it in the DB
  • recordUpload3(), previously recordUpload2()
  • publish()
• Move, delete, restore:
  • move()
  • deleteFile(), deleteOldFile()
  • restore()
• Purge:
  • invalidateCache(), purgeCache(), purgeOldThumbnails(), purgeThumbnails()
• DB:
  • upgradeRow()
• File lock
  • acquireFileLock(), releaseFileLock() - supersede lock() and unlock() since 1.38
• Load file metadata:
  • loadFromRow(), load()
• Get metadata
  • getMetadataArray(), getMetadataItems() - supersede getMetadata()
  • getJsonMetadata()
• Get description
  • getDescriptionShortUrl(), getDescriptionUrl(), getDescriptionText(), getDescription()
• Get file objects associated with page revisions
  • getHistory()
• Get upload information
  • nextHistoryLine() - Returns the history of the file, line by line
  • resetHistory() - Resets the history pointer to the first element of the history
  • getTimestamp() - get 14-character timestamp
  • getDescriptionTouched() - get timestamp (TS_MW format) of the last change of the description page
  • getUploader() - get the user who uploaded the file
• Get Repo info
  • getRepo() - returns LocalRepo
  • isMissing()
• Get other information
  • getQueryInfo() - deprecated since 1.41 in favour of FileSelectQueryBuilder class
  • exists()
  • isCacheable()
  • getSize(), getWidth(), getHeight()
  • getBitDepth()
  • getMimeType(), getMediaType()
  • getSha1() - get Secure Hash Algorithm 1 (Sha1)

In addition, many other methods are available that are inherited from File class.

See also

• Manual:File.php - contains the File class that is extended by LocalFile
• Manual:LocalRepo.php