PHP Class app\models\File

Inheritance: extends NeoEloquent
Afficher le fichier Open project: phanan/koel Class Usage Examples

Protected Properties

Свойство Type Description
$getID3 getID\getID3 The getID3 object, for ID3 tag reading.
$hash string This value is unique, and can be used to query a Song record.
$mtime integer The file's last modified time.
$path string The file's path.
$song Song The song model that's associated with this file.
$splFileInfo SplFileInf\SplFileInfo The SplFileInfo object of the file.
$syncError string The last parsing error text, if any.

Méthodes publiques

Méthode Description
__construct ( string | SplFileInf\SplFileInfo $path, getID\getID3 $getID3 = null ) Construct our File object.
getGetID3 ( ) : getID\getID3
getHash ( string $path ) : string Get a unique hash from a file path.
getInfo ( ) : array | void Get all applicable ID3 info from the file.
getPath ( ) : string
getSyncError ( ) : syncError Get the last parsing error's text.
isChanged ( ) : boolean Determine if the file is changed (its Song record is found, but the timestamp is different).
isNew ( ) : boolean Determine if the file is new (its Song record can't be found in the database).
isNewOrChanged ( ) : boolean Determine if the file is new or changed.
setGetID3 ( getID\getID3 $getID3 = null )
sync ( array $tags, boolean $force = false ) : boolean | Song Sync the song with all available media info against the database.

Private Methods

Méthode Description
getCoverFileUnderSameDirectory ( ) : string | false Issue #380.

Method Details

__construct() public méthode

Upon construction, we'll set the path, hash, and associated Song object (if any).
public __construct ( string | SplFileInf\SplFileInfo $path, getID\getID3 $getID3 = null )
$path string | SplFileInf\SplFileInfo Either the file's path, or a SplFileInfo object
$getID3 getID\getID3 A getID3 object for DI (and better performance)

getGetID3() public méthode

public getGetID3 ( ) : getID\getID3
Résultat getID\getID3

getHash() public static méthode

Get a unique hash from a file path.
public static getHash ( string $path ) : string
$path string
Résultat string

getInfo() public méthode

Get all applicable ID3 info from the file.
public getInfo ( ) : array | void
Résultat array | void

getPath() public méthode

public getPath ( ) : string
Résultat string

getSyncError() public méthode

Get the last parsing error's text.
public getSyncError ( ) : syncError
Résultat syncError

isChanged() public méthode

Determine if the file is changed (its Song record is found, but the timestamp is different).
public isChanged ( ) : boolean
Résultat boolean

isNew() public méthode

Determine if the file is new (its Song record can't be found in the database).
public isNew ( ) : boolean
Résultat boolean

isNewOrChanged() public méthode

Determine if the file is new or changed.
public isNewOrChanged ( ) : boolean
Résultat boolean

setGetID3() public méthode

public setGetID3 ( getID\getID3 $getID3 = null )
$getID3 getID\getID3

sync() public méthode

Sync the song with all available media info against the database.
public sync ( array $tags, boolean $force = false ) : boolean | Song
$tags array The (selective) tags to sync (if the song exists)
$force boolean Whether to force syncing, even if the file is unchanged
Résultat boolean | Song A Song object on success, true if file exists but is unmodified, or false on an error.

Property Details

$getID3 protected_oe property

The getID3 object, for ID3 tag reading.
protected getID3,getID $getID3
Résultat getID\getID3

$hash protected_oe property

This value is unique, and can be used to query a Song record.
protected string $hash
Résultat string

$mtime protected_oe property

The file's last modified time.
protected int $mtime
Résultat integer

$path protected_oe property

The file's path.
protected string $path
Résultat string

$song protected_oe property

The song model that's associated with this file.
protected Song,app\models $song
Résultat Song

$splFileInfo protected_oe property

The SplFileInfo object of the file.
protected SplFileInfo,SplFileInf $splFileInfo
Résultat SplFileInf\SplFileInfo

$syncError protected_oe property

The last parsing error text, if any.
protected string $syncError
Résultat string