1 | <?php |
||
17 | class HttpClientLocationCreator |
||
18 | { |
||
19 | 1 | use LoggerAwareTrait; |
|
20 | |||
21 | /** |
||
22 | * @var ClientInterface |
||
23 | */ |
||
24 | protected $client; |
||
25 | |||
26 | |||
27 | /** |
||
28 | * @var RequestFactoryInterface |
||
29 | */ |
||
30 | public $request_factory; |
||
31 | |||
32 | |||
33 | /** |
||
34 | * Geocoder API endpoint. |
||
35 | * |
||
36 | * @var string |
||
37 | */ |
||
38 | public $api; |
||
39 | |||
40 | |||
41 | /** |
||
42 | * IP adress query parameter |
||
43 | * |
||
44 | * @var string |
||
45 | */ |
||
46 | public $ip_var_name = "ip"; |
||
47 | |||
48 | |||
49 | /** |
||
50 | * @var callable |
||
51 | */ |
||
52 | public $response_decoder; |
||
53 | |||
54 | |||
55 | /** |
||
56 | * @var mixed |
||
57 | */ |
||
58 | public $default_location; |
||
59 | |||
60 | |||
61 | /** |
||
62 | * @var string |
||
63 | */ |
||
64 | protected $error_loglevel = LogLevel::ERROR; |
||
65 | |||
66 | |||
67 | /** |
||
68 | * @param string $api Geocoder API endpoint |
||
69 | * @param ClientInterface $client PSR-18 HTTP Client |
||
70 | * @param RequestFactoryInterface $request_factory PSR-17 Request factory |
||
71 | * @param callable|null $response_decoder Optional: PSR-7 Response decoder callable |
||
72 | */ |
||
73 | 2 | public function __construct( string $api, ClientInterface $client, RequestFactoryInterface $request_factory, callable $response_decoder = null, LoggerInterface $logger = null) |
|
81 | |||
82 | |||
83 | |||
84 | /** |
||
85 | * @param string $client_ip Client IP address |
||
86 | */ |
||
87 | 2 | public function __invoke( string $client_ip ) |
|
127 | |||
128 | |||
129 | |||
130 | /** |
||
131 | 4 | * @param string $client_ip Client IP address |
|
132 | * @return RequestInterface |
||
133 | 4 | */ |
|
134 | 4 | public function createRequest( string $client_ip ) : RequestInterface |
|
143 | |||
144 | |||
145 | 2 | ||
146 | /** |
||
147 | 2 | * @param ResponseInterface $response |
|
148 | 2 | * @return mixed |
|
149 | */ |
||
150 | public function decodeResponse(ResponseInterface $response) |
||
156 | |||
157 | |||
158 | 4 | ||
159 | /** |
||
160 | 4 | * Sets the default location to return on error |
|
161 | 4 | * |
|
162 | * @param mixed $location |
||
163 | */ |
||
164 | public function setDefaultLocation( $location ) : self |
||
169 | |||
170 | |||
171 | 6 | /** |
|
172 | * @param string $error_loglevel PSR-3 Loglevel name |
||
173 | 6 | */ |
|
174 | 6 | public function setErrorLoglevel( string $error_loglevel ) { |
|
178 | |||
179 | |||
180 | /** |
||
181 | * Sets the API endpoint |
||
182 | * |
||
183 | 4 | * @param string $api |
|
184 | */ |
||
185 | 4 | public function setApiEndpoint( string $api ) : self |
|
190 | |||
191 | |||
192 | |||
193 | /** |
||
194 | * Sets the HTTP Client to use. |
||
195 | 4 | * |
|
196 | * @param ClientInterface $client |
||
197 | 4 | */ |
|
198 | 4 | public function setClient( ClientInterface $client ) : self |
|
203 | |||
204 | |||
205 | /** |
||
206 | * Sets the PSR-17 Request factory |
||
207 | * |
||
208 | * @param RequestFactoryInterface $request_factory |
||
209 | */ |
||
210 | public function setRequestFactory( RequestFactoryInterface $request_factory ) : self |
||
215 | |||
216 | |||
217 | /** |
||
218 | * Sets the PSR-7 Response decoder callable. |
||
219 | * |
||
220 | * @param callable $response_decoder |
||
221 | */ |
||
222 | public function setResponseDecoder( callable $response_decoder = null ) : self |
||
227 | |||
228 | } |
||
229 |
In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code:
Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: