| @@ 8-60 (lines=53) @@ | ||
| 5 | * Class Fragment |
|
| 6 | * @package Subreality\Dilmun\Anshar\Http\UriParts |
|
| 7 | */ |
|
| 8 | class Fragment extends AbstractUriPart |
|
| 9 | { |
|
| 10 | protected $unencoded_characters = array("/", "?"); |
|
| 11 | ||
| 12 | /** |
|
| 13 | * Fragment constructor. Accepts a string representing a URI fragment. Construction will throw an exception if the |
|
| 14 | * fragment is not a string. |
|
| 15 | * |
|
| 16 | * Construction accepts strings that have been percent-encoded as well as strings that have not been percent-encoded |
|
| 17 | * and will encode invalid characters. |
|
| 18 | * |
|
| 19 | * Construction with a string that includes both encoded and decoded characters will be assumed to be an encoded |
|
| 20 | * string, resulting in double-encoding. |
|
| 21 | * |
|
| 22 | * fragment = *( pchar / "/" / "?" ) |
|
| 23 | * pchar = unreserved / pct-encoded / sub-delims / ":" / "@" |
|
| 24 | * unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~" |
|
| 25 | * pct-encoded = "%" HEXDIG HEXDIG |
|
| 26 | * sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "=" |
|
| 27 | * |
|
| 28 | * @see https://tools.ietf.org/html/rfc3986#appendix-A |
|
| 29 | * |
|
| 30 | * @throws \InvalidArgumentException |
|
| 31 | * |
|
| 32 | * @param string $fragment A string representing a URI fragment |
|
| 33 | */ |
|
| 34 | public function __construct($fragment) |
|
| 35 | { |
|
| 36 | parent::__construct($fragment, "Fragment"); |
|
| 37 | } |
|
| 38 | ||
| 39 | /** |
|
| 40 | * Returns a string representation of the fragment formatted so that it can be compiled into a complete URI string |
|
| 41 | * per the Uri object's string specification. |
|
| 42 | * |
|
| 43 | * If the fragment is empty, toUriString returns an empty string; if the fragment is not empty, toUriString returns |
|
| 44 | * the fragment prefixed with a octothorpe(#). |
|
| 45 | * |
|
| 46 | * @see Uri::__toString |
|
| 47 | * |
|
| 48 | * @return string A string representation of the fragment formatted for a complete URI string |
|
| 49 | */ |
|
| 50 | public function toUriString() |
|
| 51 | { |
|
| 52 | $uri_fragment = parent::toUriString(); //returns data string |
|
| 53 | ||
| 54 | if (!empty($uri_fragment)) { |
|
| 55 | $uri_fragment = "#" . $uri_fragment; |
|
| 56 | } |
|
| 57 | ||
| 58 | return $uri_fragment; |
|
| 59 | } |
|
| 60 | } |
|
| 61 | ||
| @@ 8-60 (lines=53) @@ | ||
| 5 | * Class Query |
|
| 6 | * @package Subreality\Dilmun\Anshar\Http\UriParts |
|
| 7 | */ |
|
| 8 | class Query extends AbstractUriPart |
|
| 9 | { |
|
| 10 | protected $unencoded_characters = array("/", "?"); |
|
| 11 | ||
| 12 | /** |
|
| 13 | * Query constructor. Accepts a string representing a URI query. Construction will throw an exception if the |
|
| 14 | * query is not a string. |
|
| 15 | * |
|
| 16 | * Construction accepts strings that have been percent-encoded as well as strings that have not been percent-encoded |
|
| 17 | * and will encode invalid characters. |
|
| 18 | * |
|
| 19 | * Construction with a string that includes both encoded and decoded characters will be assumed to be an encoded |
|
| 20 | * string, resulting in double-encoding. |
|
| 21 | * |
|
| 22 | * query = *( pchar / "/" / "?" ) |
|
| 23 | * pchar = unreserved / pct-encoded / sub-delims / ":" / "@" |
|
| 24 | * unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~" |
|
| 25 | * pct-encoded = "%" HEXDIG HEXDIG |
|
| 26 | * sub-delims = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "=" |
|
| 27 | * |
|
| 28 | * @see https://tools.ietf.org/html/rfc3986#appendix-A |
|
| 29 | * |
|
| 30 | * @throws \InvalidArgumentException |
|
| 31 | * |
|
| 32 | * @param string $query A string representing a URI query |
|
| 33 | */ |
|
| 34 | public function __construct($query) |
|
| 35 | { |
|
| 36 | parent::__construct($query, "Query"); |
|
| 37 | } |
|
| 38 | ||
| 39 | /** |
|
| 40 | * Returns a string representation of the query formatted so that it can be compiled into a complete URI string |
|
| 41 | * per the Uri object's string specification. |
|
| 42 | * |
|
| 43 | * If the query is empty, toUriString returns an empty string; if the query is not empty, toUriString returns the |
|
| 44 | * query prefixed with a question mark. |
|
| 45 | * |
|
| 46 | * @see Uri::__toString |
|
| 47 | * |
|
| 48 | * @return string A string representation of the query formatted for a complete URI string |
|
| 49 | */ |
|
| 50 | public function toUriString() |
|
| 51 | { |
|
| 52 | $uri_query = parent::toUriString(); //returns data string |
|
| 53 | ||
| 54 | if (!empty($uri_query)) { |
|
| 55 | $uri_query = "?" . $uri_query; |
|
| 56 | } |
|
| 57 | ||
| 58 | return $uri_query; |
|
| 59 | } |
|
| 60 | } |
|
| 61 | ||