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