README

Description

Little methods collection in order to manipulate variables contents. Group of some features in order to clean, modify, convert, apply math operations and some other actions

Install

composer require juanchosl/datamanipulation

Manipulators

Strings

Perform actions over strings, using multibyte functions where are available, and returns a new StringManipulator object in order to mantain inmutability over previous entities

Numbers

echo (string)(NumbersManipulators($pvu = 100))
    ->product($units = 10)
    ->increasePercent($taxes = 21); 
    
//1210

Date + Times

Check, parse a value as a date from some origins and formats, and retunrs a DateTime instance

Create from excel time value

echo  (new DateManipulators())
    ->fromExcel(46023)
    ->format("Y-m-d");
    
// 2026-01-01

Create from timestamp

echo  (new DateManipulators())
    ->fromTimestamp(1735689600)
    ->format("Y-m-d");

// 2026-01-01

Create from string

echo  (new DateManipulators())
    ->fromString("Thursday, 01-Jan-26 00:00:00 UTC")
    ->format("Y-m-d");

// 2026-01-01

Create from knowed format

echo  (new DateManipulators())
    ->fromFormatString(20260101, "Ymd")
    ->format("Y-m-d");

// 2026-01-01

Sanitizers

Filter, clean and convert contents variables, for use from forms, file contents, DTOs or other origins

• Strings
• Numbers

Strings

Clean Email

FILTER_SANITIZE_EMAIL.

$sanitizer = (new StringSanitizers())->email();
echo $sanitizer('Juan. Sanchez@tecnicosweb.com'); //Juan.Sanchez@tecnicosweb.com

Clean URL

FILTER_SANITIZE_URL.

Add Slashes

FILTER_SANITIZE_ADD_SLASHES.

$sanitizer = (new StringSanitizers())->addSlashes();
echo $sanitizer('SELECT * FROM "table"'); //SELECT * FROM \"table\"

HTML Special Chars

FILTER_SANITIZE_FULL_SPECIAL_CHARS.

$sanitizer = (new StringSanitizers())->htmlSpecialChars();
echo $sanitizer('<div>Text</div>'); //&lt;div&gt;Text&lt;/div&gt;

Strip HTML Tags

strip_tags.

$sanitizer = (new StringSanitizers())->stripTags();
echo $sanitizer('<div>Text</div>'); //Text

Combine Sanitizators

$sanitizator= (new StringSanitizers())->stripTags()->htmlSpecialChars();
echo $sanitizator("<div>Camión&\r\n</div>"); //"Cami&oacute;n&amp;\r\n"

Extended String Sanitizators

setStripBacktick

Remove or not the backtick character, an executor for unix terminals, in order to avoid code execution

setStripChars

You can indicate if would remove the control ASCII chars (less than 32) or the extended ASCII codes (greather than 127)

setEncodeChars

You can indicate if would encode the control ASCII chars (less than 32) or the extended ASCII codes (greather than 127)

unsafe

FILTER_UNSAFE_RAW.+ FILTER_FLAG_EMPTY_STRING_NULL

safe

FILTER_SANITIZE_SPECIAL_CHARS. + FILTER_FLAG_EMPTY_STRING_NULL

urlEncode

FILTER_SANITIZE_ENCODED. + FILTER_FLAG_EMPTY_STRING_NULL

hmtlEncode

FILTER_SANITIZE_SPECIAL_CHARS. + FILTER_FLAG_EMPTY_STRING_NULL + FILTER_FLAG_ENCODE_AMP

$sanitizator= (new StringSanitizers())->stripTags()->htmlSpecialChars();
echo $sanitizator("<div>Camión&\r\n</div>"); //"Cami&oacute;n&amp;\r\n"

Numbers

Can extract and parse from an origin, the numeric part, extracting the integer or float contained, removing (or not) the thousand separators. Into code, the colon is a parameters separator, for this reason, by default, we don't preserve it, but you can preserve thousand separator pasing TRUE.

Floats

FILTER_SANITIZE_NUMBER_FLOAT. + FILTER_FLAG_ALLOW_THOUSAND

$sanitizer = (new NumberSanitizers())->float($with_thousand_separator = false);
echo $sanitizer('2,000.22€'); //2000.22

Integers

FILTER_SANITIZE_NUMBER_INT. + FILTER_FLAG_ALLOW_THOUSAND

$sanitizer = (new NumberSanitizers())->integer($with_thousand_separator = false);
echo $sanitizer('Z123456789N'); //123456789

For integer sanitization, the FILTER_FLAG_ALLOW_FRACTION is not used, allways perform a number_format with 0 fraction for remove the decimals, taken only the integer part, not just removing dot

$sanitizer = (new NumberSanitizers())->integer($with_thousand_separator = false);
echo $sanitizer('2,000.22€'); //2000