U

Produce a Python-style get() to avoid use of ternary operator

Get the last bit of the path

input: /py4e/lessons/intro?x=2 output: intro

Get the protocol, host, and port from an absolute URL

input: http://localhost:8888/tsugi output: http://localhost:8888

Get the path to the current request, w/o trailing slash

input: /py4e/lessons/intro?x=2 output: /py4e/lessons/intro

input: /py4e/lessons/intro/?x=2 output: /py4e/lessons/intro

Get the path to one above the current request, w/o trailing slash

input: /py4e/lessons/intro?x=2 output: /py4e/lessons

input: /py4e/lessons/intro/?x=2 output: /py4e/lessons/intro

Get the controller for the current request

executing script: /py4e/koseu.php input: /py4e/lessons/intro?x=2 output: (/py4e, lessons, intro)

input: /py4e/lessons/intro/?x=2 output: /py4e/lessons/intro

Return a rest-path

This knows the current working folder we are in. The model is that a folder is an "application" with many possible controllers and within each controller there are actions followed by parameters.

for example, assume these files exist in a folder:

../tsugi/mod/zap/index.php
../tsugi/mod/zap/rows.php
../tsugi/mod/zap/store.php

If this URL were called with .htaccess and tsugi.php set up, rows.php would be run and this would be the output:

http://localhost:8888/tsugi/mod/zap/rows/add/1/2
base_url: http://localhost:8888
parent:  /tsugi/mod/zap
current:  /tsugi/mod/zap/rows
controller: rows
action: add
parameters: (1, 2)
full: /tsugi/mod/zap/rows/add/1/2

As a special case, when the index.php runs (not through tsugi.php) The results are as follows:

http://localhost:8888/tsugi/mod/zap/
base_url: http://localhost:8888
parent:  /tsugi/mod/zap
current:  /tsugi/mod/zap
controller: empty string
action: empty string
parameters: empty array
full: /tsugi/mod/zap

Remove any relative elements from a path

Before After a/b/c a/b/c a/b/c/ a/b/c/ a/./c/ a/c/ a/../c/ c/

Return the URL as seen by PHP (no query string or parameters)

Borrowed from from_request on OAuthRequest.php

Tightly serialize an integer-only PHP array

$arar = Array ( 1 => 42 ,2 => 43, 3 => 44 ); $str = U::array_Integer_Serialize($arar); echo($str); // 1=42,2=43,3=44

https://stackoverflow.com/questions/30231476/i-want-to-array-key-and-array-value-comma-separated-string

Deserialize an tightly serialized integer-only PHP array

$str = '1=42,2=43,3=44'; $arar = U::array_Integer_Deserialize($str); print_r($arar); // Array ( '1' => 42 ,'2' => 43, '3' => 44 );

https://stackoverflow.com/questions/4923951/php-split-string-in-key-value-pairs

Pull off the first element of a key/value array

$arr = array('x'=>'ball','y'=>'hat','z'=>'apple'); print_r($arr); print_r(array_kshift($arr)); // [x] => ball print_r($arr);

http://php.net/manual/en/function.array-shift.php#84179

Give the current time in the "conversion format"

201711261315

Return if APC cache is available (Deprecated)

Return if APCU cache is available

Create a unique GUID return string

https://www.texelate.co.uk/blog/create-a-guid-with-php

Validate a CSS color value

Build a PHP 7 strlen for PHP 8.2 and later

This is needed because in PHP 8.2 strlen() demands a string (i.e. can't handle false, etc)

Determine if a variable is empty

This is needed because in PHP 8.2 strlen() demands a string (i.e. can't handle false, etc) Sadly, empty('0') becomes falsey and so returns true - What??

The method name is taken from Java since its rules are corect.

https://docs.oracle.com/javase/8/docs/api/java/lang/String.html#isEmpty--

Imitate StringUtils.isNotEmpty()

Sigh, Java 8.0 does not have isNotEmpty - which is super useful so we imitate

https://commons.apache.org/proper/commons-lang/javadocs/api-3.3/org/apache/commons/lang3/StringUtils.html

It is the little things - sigh.

Check if a key in an array is not empty

Make an htmlentities() that is more tolerant than the PHP 8.2 version.

https://commons.apache.org/proper/commons-text/apidocs/org/apache/commons/text/StringEscapeUtils.html

Build an "always works" json_decode()

This is needed because in PHP 8.2 json_decode() demands a string (i.e. can't handle false, etc)