README

Requirements

PHP ^8.2 (tested on 8.2, 8.3 and 8.5). Use version 2.x for PHP 8.0 and 8.1.

Installation

$ composer require paliari/php-utils

Tests

$ composer install
$ composer test

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 stdout.

    
    //Methods avaliables: "critical, error, warning, notice, info, debug".
    
    // info 
    \Paliari\Utils\Logger::info('Yor custom message.');
    
    // custom writer, receives ($machine, $level, $message, $scope)
    \Paliari\Utils\Logger::setWriteCustom(function ($machine, $level, $message, $scope) {
        file_put_contents(__DIR__ . '/tmp/logs/app.log', "$level - $message\n", FILE_APPEND);
    });

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'];
    });

The handler runs inside an output buffer callback: return the content instead of using echo/print (producing output from output handlers is deprecated since PHP 8.5).

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

paliari / php-utils

Package info

Security

Statistics