paliari/php-utils

PHP utils

2.0.1 2023-10-31 12:33 UTC

Requires

• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^5.7

MIT

• Marcos Paliari

README

Installation

$ composer require paliari/php-utils

Usage

Bump

Increment version of composer.json.

Params:

• --git or -g Commit composer.json bumped and create the git tag

• --version or -v Version type <major | minor | patch | prerelase> or custom version <1.0.0-pre1>. Default is patch

• --file or -f Composer json file <composer.json>. Default is composer.json

    $ vendor/bin/bump -v major -f custom_composer.json -g
    Or
    $ vendor/bin/bump --version 1.0.0 --file custom_composer.json --git
    Or
    $ vendor/bin/bump -v minor --git
  

Array

Array facades.

    $a1 = ['a' => 1];
    $a2 = ['b' => ['b1' => 2]];
    $a3 = \Paliari\Utils\A::merge($a1, $a2);
    var_export($a3);
    // export to ['a' => 1, 'b' => ['b1' => 2]]
    
    $val = \Paliari\Utils\A::deepKey($a3, 'b.b1');
    var_export($val);
    // export to 2;

    $flatten = \Paliari\Utils\A::flatten($a3);
    var_export($flatten);
    // export to [1, 2];

    

Function

    // explode string of space, aliases to explode(' ', $str);
    $str = 'a b 1.3d a-x';
    $a = w($str);
    var_export($a);
    // export to ['a', 'b', '1.3d', 'a-x'];
    

Logger

Write log to file

    
    // config custom file log, default is realpath(sys_get_temp_dir()) . '/php-util.log'
    $file = __DIR__.'/tmp/logs/test.log';
    \Paliari\Utils\Logger::file($file); 
    
    //Methods avaliables: "critical, error, warning, notice, info, debug".
    
    // info 
    \Paliari\Utils\Logger::info('Yor custom message.');
    

CatchFatalError

    
    // Init
    \Paliari\Utils\CatchFatalError::init();
    // Or
    \Paliari\Utils\CatchFatalError::init(function ($e) {
        // ... custom handler actions, ex: send mail, save custom log...
        return $e['message'];
    });
    

Url

Facade of url parse.

    
    // Example
    $url = 'https://domain.com/home/?p=1&q[a]=11&q[b]=22#/home';
    $u = \Paliari\Utils\Url::parse($url);
    var_export($u);
    // expected
    /*
    Paliari\Utils\Url::__set_state(array(
       'scheme' => 'https',
       'host' => 'domain.com',
       'port' => NULL,
       'user' => NULL,
       'pass' => NULL,
       'path' => '/home/',
       'query' => 'p=1&q[a]=11&q[b]=22',
       'fragment' => '/home',
       'url' => 'https://domain.com/home/?p=1&q[a]=11&q[b]=22#/home',
    ))
    */

    // Method queryToArray convert query string to array.
    var_export($u->queryToArray());
    // expected
    /*
    array (
      'p' => '1',
      'q' => 
      array (
        'a' => '11',
        'b' => '22',
      ),
    )
    */
    

Authors

• Marcos Paliari