firepot

Back Back Up Advanced Editor

<?php
/**
 * Abstracts information about a file into a view parameter object.
 * 
 * @property-read string $name
 * @property-read string $path
 * @property-read string $relpath
 * @property-read string $size
 * @property-read int $imode
 * @property-read string $smode
 * @property-read string $group
 * @property-read string $owner
 */
class Loco_mvc_FileParams extends Loco_mvc_ViewParams {
    
    /**
     * File reference from which to take live properties.
     * @var Loco_fs_File
     */
    private $file;
    
    
    /**
     * Print property as a number of bytes in larger denominations
     * @param int $n
     * @return string 
     */
    public static function renderBytes( $n ){
        $i = 0;
        $dp = 0;
        while( $n >= 1024 ){
            $i++;
            $dp++;
            $n /= 1024;
        }
        $s = number_format( $n, $dp, '.', ',' );
        // trim trailing zeros from decimal places
        $a = explode('.',$s);
        if( isset($a[1]) ){
            $s = $a[0];
            $d = trim($a[1],'0') and $s .= '.'.$d;
        }
        $units = [ ' bytes', ' KB', ' MB', ' GB', ' TB' ];
        $s .= $units[$i];
        
        return $s;
    }

/**
     * @return Loco_mvc_FileParams 
     */
    public static function create( Loco_fs_File $file ) {
        return new Loco_mvc_FileParams( [], $file );
    }

/**
     * Override does lazy property initialization
     * @param array $props initial extra properties
     */
    public function __construct( array $props, Loco_fs_File $file ){
        parent::__construct(  [
            'name' => '',
            'path' => '',
            'relpath' => '',
            'reltime' => '',
            'bytes' => 0,
            'size' => '',
            'imode' => '',
            'smode' => '',
            'owner' => '',
            'group' => '',
        ] + $props );
        $this->file = $file;
    }

/**
     * {@inheritdoc}
     * Override to get live information from file object
     */
    #[ReturnTypeWillChange]
    public function offsetGet( $prop ){
        $getter = [ $this, '_get_'.$prop ];
        if( is_callable($getter) ){
            return call_user_func( $getter );
        }
        return parent::offsetGet($prop);
    }

/**
     * {@inheritdoc}
     * Override to ensure all properties populated
     */
    #[ReturnTypeWillChange]
    public function getArrayCopy(){
        $a = [];
        foreach( $this as $prop => $dflt ){
            $a[$prop] = $this[$prop];
        }
        return $a;
    }

/**
     * @internal
     * @return string
     */    
    private function _get_name(){
        return  $this->file->basename();
    }

/**
     * @internal
     * @return string
     */    
    private function _get_path(){
        return  $this->file->getPath();
    }

/**
     * @internal
     * @return string
     */
    private function _get_relpath(){
        return $this->file->getRelativePath( loco_constant('WP_CONTENT_DIR') );
    }

/**
     * Using slightly modified version of WordPress's Human time differencing
     * + Added "Just now" when in the last 30 seconds
     * @internal
     * @return string
     */
    private function _get_reltime(){
        $time = $this->has('mtime') ? $this['mtime'] : $this->file->modified();
        $time_diff = time() - $time;
        // use same time format as posts listing when in future or more than a day ago
        if( $time_diff < 0 || $time_diff >= 86400 ){
            return Loco_mvc_ViewParams::date_i18n( $time, __('Y/m/d','default') );
        }
        if( $time_diff < 30 ){
            // translators: relative time when something happened in the last 30 seconds
            return __('Just now','loco-translate');
        }
        // translators: %s: Human-readable time difference.
        return sprintf( __('%s ago','default'), human_time_diff($time) );
    }

/**
     * @internal
     * @return int
     */
    private function _get_bytes(){
        return $this->file->size();
    }

/**
     * @internal
     * @return string
     */
    private function _get_size(){
        return self::renderBytes( $this->_get_bytes() );
    }

/**
     * Get octal file mode
     * @internal
     * @return string
     */
    private function _get_imode(){
        $mode = new Loco_fs_FileMode( $this->file->mode() );
        return (string) $mode;
    }

/**
     * Get rwx file mode
     * @internal
     * @return string
     */
    private function _get_smode(){
        $mode = new Loco_fs_FileMode( $this->file->mode() );
        return $mode->format();
    }

/**
     * Get file owner name
     * @internal
     * @return string
     */
    private function _get_owner(){
        if( ( $uid = $this->file->uid() ) && function_exists('posix_getpwuid') && ( $a = posix_getpwuid($uid) ) ){
            return $a['name'];
        }
        return sprintf('%u',$uid);
    }

/**
     * Get group owner name
     * @internal
     * @return string
     */
    private function _get_group(){
        if( ( $gid = $this->file->gid() ) && function_exists('posix_getpwuid') && ( $a = posix_getgrgid($gid) ) ){
            return $a['name'];
        }
        return sprintf('%u',$gid);
    }

/**
     * Print pseudo console line
     * @return string;
     */
    public function ls(){
        $this->e('smode');
        echo '  ';
        $this->e('owner');
        echo ':';
        $this->e('group');
        echo '  ';
        $this->e('relpath');
        return '';
    }
    
}