echron/tools

Tools library for PHP

1.7.0 2024-07-29 20:24 UTC

Requires

• php: >=8.1
• ext-dom: *
• ext-json: *
• ext-libxml: *
• ext-mbstring: *
• ext-simplexml: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^v3.17.0
• phpmd/phpmd: ^2.12.0
• phpstan/phpstan: ^1.10.16
• phpunit/phpunit: ^10.1.2
• thecodingmachine/phpstan-safe-rule: ^v1.2.0

MIT

• Stijn Duynslaeger

README

About

Echron PHP Tool library offers a set of handy classes and methods to simplify PHP development.

Installation

Install the latest version with

composer require echron/tools

Usage

Output seconds as human-readable string

echo \Echron\Tools\Time::readableSeconds(60 * 24);
>> 24 minutes
echo \Echron\Tools\Time::readableSeconds(60 + 3.4221580028534);
>> 1 minute, 3.42 seconds
echo \Echron\Tools\Time::readableSeconds(3.455669555);
>> 3.46 seconds

Check if array has duplicates

$a = \Echron\Tools\ArrayHelper::hasDuplicates(['red', 'green', 'purple']);
print_r($a);
>> false

$b = \Echron\Tools\ArrayHelper::hasDuplicates(['red', 'green', 'purple','red]);
print_r($b);
>> true

Filter array by unique values

$a = \Echron\Tools\ArrayHelper::unique(['red', 'green', 'purple'],['orange','red']);
print_r($a);
>> ['red','green','purple','orange']

Limit a string without cutting of words

$a = \Echron\Tools\StringHelper::limitWords('This is a basic string', 20);
print_r($a);
>> "This is a basic"

It is possible to pass along an end marker that will be added to the endof the string when the string is truncated. The end marker is included in the maximum character string, the result will not be longer than the maximum characters even when the end marker is added.

$result = \Echron\Tools\StringHelper::limitWords('This is a basic string', 20, ' ...');
print_r($result);
>> "This is a basic ..."

Limit a string

$result = \Echron\Tools\StringHelper::limit('This is a basic string', 20);
print_r($result);
>> "This is a basic stri"

Add an end marker

$result = \Echron\Tools\StringHelper::limit('This is a basic string', 20, ' ...');
print_r($result);
>> "This is a basic  ...', $result)"

CSV

• Read out CSV file into an array

$result = \Echron\Tools\CsvHelper::parseCSVFile('file.csv');

• Write a CSV file based on an array

$result = \Echron\Tools\CsvHelper::toCSVFile(['field'=> 'value'], 'file.csv');