Proxy now requires CURL extension

Author: mtmail

CHANGES.txt

@@ -4,7 +4,7 @@
 - host and proxy parameter have to be set before calling geocode(). Values are now
    stricter. In the last 30 days no customer used either option.
 - Explicitly enforce SSL certificate verification in both CURL and fopen.
-- Add proxy support to fopen fallback
+- Proxy now requires CURL extension; raises explicit error with fopen fallback
 - Fix stream context not being passed to file_get_contents
 
 3.3.4 -- Mon Dec 15 2025

src/AbstractGeocoder.php

@@ -83,6 +83,9 @@ protected function getJSON($query)
             $ret = $this->getJSONByCurl($query);
             return $ret;
         } elseif (ini_get('allow_url_fopen')) {
+            if ($this->proxy) {
+                throw new \Exception('Proxy support requires the CURL extension');
+            }
             $ret = $this->getJSONByFopen($query);
             return $ret;
         } else {
@@ -92,18 +95,12 @@ protected function getJSON($query)
 
     protected function getJSONByFopen($query)
     {
-        $httpOptions = [
-            'user_agent' => $this->user_agent,
-            'timeout' => $this->timeout
-        ];
-        if ($this->proxy) {
-            $httpOptions['proxy'] = $this->proxy;
-            $httpOptions['request_fulluri'] = true;
-        }
-
         $context = stream_context_create(
             [
-                'http' => $httpOptions,
+                'http' => [
+                    'user_agent' => $this->user_agent,
+                    'timeout' => $this->timeout
+                ],
                 'ssl' => [
                     'verify_peer' => true,
                     'verify_peer_name' => true

tests/GeocoderTest.php

@@ -83,7 +83,11 @@ public function testProxy()
         }
         // https://opencagedata.com/api#testingkeys
         $geocoder = new Geocoder('6d0e711d72d74daeb2b0bfd2a5cdfdba');
-        $geocoder->setProxy($proxy);
+        try {
+            $geocoder->setProxy($proxy);
+        } catch (\Exception $e) {
+            $this->markTestSkipped('PROXY environment variable is not a valid proxy URL: ' . $proxy);
+        }
         $query = "82 Clerkenwell Road, London";
         $result = $geocoder->geocode($query);