Wallogit.com
2017 © Pedro Peláez
A filtering implementation for verifying strings
, (*1)
, (*2)
, (*3)
A filtering implementation for verifying the contents of strings and some common formats of strings., (*4)
Requires PHP 7.0 or newer and uses composer to install further PHP dependencies. See the composer specification for more details., (*5)
filter-strings-php can be installed for use in your project using composer.
The recommended way of using this library in your project is to add a composer.json file to your project. The following contents would add filter-strings-php as a dependency:, (*6)
composer require traderinteractive/filter-strings
This filter verifies that the argument is a string. The second parameter can be set to true to allow
null values through without an error (they will stay null and not get converted to false). The last parameters specify the length bounds of the
string. The default bounds are 1+, so an empty string fails by default., (*7)
The following checks that $value is a non-empty string., (*8)
\TraderInteractive\Filter\Strings::filter($value);
This filter concatenates the given $value, $prefix and $suffix and returns the resulting string., (*9)
$value = \TraderInteractive\Filter\Strings::concat('middle', 'begining_', '_end');
assert($value === 'begining_middle_end');
This filter will accept a string value and return its translated value found in the given $valueMap., (*10)
$value = \TraderInteractive\Filter\Strings::translate('active', ['inactive' => 'X', 'active' => 'A']);
assert($value === 'A');
This filter is essentially a wrapper around the built-in explode method
with the value first in order to work with the Filterer. It also defaults to using , as a delimiter. For example:, (*11)
$value = \TraderInteractive\Filter\Strings::explode('abc,def,ghi');
assert($value === ['abc', 'def', 'ghi']);
This filter trims and remove superfluous whitespace from a given string., (*12)
$value = \TraderInteractive\Filter\Strings::compress(' a string with lots of whitespace ');
assert($value === 'a string with lots of whitespace');
This filter can also replace vertical whitespace such as newlines with single spaces., (*13)
$value = \TraderInteractive\Filter\Strings::compress(" a string\nwith lots\nof \nnewlines\n ", true);
assert($value === 'a string with lots of newlines');
This filter will remove specified words from a string or, optionally, replace each letter of the words with a replacement character., (*14)
The second argument specifies the words that should be replaced and can either be an array of strings or a callable that returns an array of strings., (*15)
The third argument specifies the replacement character. If empty, the words will be removed entirely. If a string with more than one character is provided, only the first character will be used., (*16)
$value = \TraderInteractive\Filter\Strings::redact('a string with some unwanted words', ['unwanted', 'words'], '*');
assert($value === 'a string with some ******** *****');
This filter will strip HTML, XML, and PHP tags from a string. This filter also accepts null values, which will be returned as null., (*17)
The second, optional argument specifies a replacement string for the removed HTML and XML tags. PHP tags will be stripped without a replacement., (*18)
\TraderInteractive\Filter\Strings::stripTags('<div>a string with<br/>tags</div>', ' ');
assert($value === ' a string with tags ');
This filter verifies that the argument is a URL string according to
RFC2396. The second parameter can be set to true to allow
null values through without an error (they will stay null and not get converted to false)., (*19)
The following checks that $value is a URL., (*20)
\TraderInteractive\Filter\Url::filter($value);
This filter verifies that the argument is an email., (*21)
The following checks that $value is an email., (*22)
\TraderInteractive\Filter\Email::filter($value);
This filter verifies that the value is in a valid JSON format., (*23)
The second parameter can be set to true to allow null values through without an error., (*24)
The third parameter determines the maximum recursion depth that is allowed., (*25)
The following checks that $value is a valid JSON string., (*26)
\TraderInteractive\Filter\Json::validate($value);
This filter parses a valid JSON string into an array, int, double, or bool. Invalid JSON will throw an error., (*27)
The second parameter can be set to true to allow null values through without an error., (*28)
The third parameter determines the maximum recursion depth that is allowed., (*29)
The following checks that $value is a valid JSON string and parses it into an array., (*30)
$value = '{ "string": "value", "array": [1, 2, 3] }';
\TraderInteractive\Filter\Json::parse($value);
assert($value === ['string' => 'value', 'array' => [1, 2, 3]]);
This filter ensures the given string is valid XML., (*31)
$value = "<root><outer><inner>value</inner></outer></root>"; $filtered = \TraderInteractive\Filter\XmlFilter::filter($value); assert($value === $filtered);
This filter accepts an XML string and an xpath. It will return the single element found at the xpath., (*32)
$value = <<<XML
<?xml version="1.0"?>
<books>
<book id="bk101">
<author>Gambardella, Matthew</author>
<title>XML Developers Guide</title>
<genre>Computer</genre>
<price>44.95</price>
<publish_date>2000-10-01</publish_date>
<description>An in-depth look at creating applications with XML.</description>
</book>
<book id="bk102">
<author>Ralls, Kim</author>
<title>Midnight Rain</title>
<genre>Fantasy</genre>
<price>5.95</price>
<publish_date>2000-12-16</publish_date>
<description>A former architect battles corporate zombies</description>
</book>
</books>
XML;
$xpath = '//book[@id="bk102"]';
$filtered = \TraderInteractive\Filter\XmlFilter::extract($value, $xpath);
$expected = <<<XML
<book id="bk102">
<author>Ralls, Kim</author>
<title>Midnight Rain</title>
<genre>Fantasy</genre>
<price>5.95</price>
<publish_date>2000-12-16</publish_date>
<description>A former architect battles corporate zombies</description>
</book>
XML;
assert($filtered === $expected);
This filter accepts an XML string and a filepath to an XSD. It ensures the given XML is valid using the given XSD and returns the original XML., (*33)
$value = <<<XML
<?xml version="1.0"?>
<books>
<book id="bk101">
<author>Gambardella, Matthew</author>
<title>XML Developers Guide</title>
<genre>Computer</genre>
<price>44.95</price>
<publish_date>2000-10-01</publish_date>
<description>An in-depth look at creating applications with XML.</description>
</book>
<book id="bk102">
<author>Ralls, Kim</author>
<title>Midnight Rain</title>
<genre>Fantasy</genre>
<price>5.95</price>
<publish_date>2000-12-16</publish_date>
<description>A former architect battles corporate zombies</description>
</book>
</books>
XML;
$xsdFilePath = 'books.xsd';
$filtered = \TraderInteractive\Filter\XmlFilter::validate($value, $xsdFilePath);
assert($filtered === $value);
Developers may be contacted at:, (*34)
With a checkout of the code get Composer in your PATH and run:, (*35)
./vendor/bin/phpcs ./vendor/bin/phpunit
For more information on our build process, read through out our Contribution Guidelines., (*36)
A filtering implementation for verifying strings
MIT
email url strings utility string
A filtering implementation for verifying strings
MIT
email url strings utility string