Merge pull request #1569 from miguelbalboa/master

Added curl ntlm auth support

docs/request-options.rst

@@ -162,6 +162,20 @@ digest
     creating a replacement that can be used with any HTTP handler is
     planned.
 
+ntlm
+    Use `Microsoft NTLM authentication <https://msdn.microsoft.com/en-us/library/windows/desktop/aa378749(v=vs.85).aspx>`_
+    (must be supported by the HTTP handler).
+
+.. code-block:: php
+
+    $client->request('GET', '/get', [
+        'auth' => ['username', 'password', 'ntlm']
+    ]);
+
+.. note::
+
+    This is currently only supported when using the cURL handler.
+
 
 body
 ----

src/Client.php

@@ -352,6 +352,10 @@ private function applyOptions(RequestInterface $request, array &$options)
                     $options['curl'][CURLOPT_HTTPAUTH] = CURLAUTH_DIGEST;
                     $options['curl'][CURLOPT_USERPWD] = "$value[0]:$value[1]";
                     break;
+                case 'ntlm':
+                    $options['curl'][CURLOPT_HTTPAUTH] = CURLAUTH_NTLM;
+                    $options['curl'][CURLOPT_USERPWD] = "$value[0]:$value[1]";
+                    break;
             }
         }
 

src/Handler/StreamHandler.php

@@ -301,6 +301,16 @@ private function createStream(RequestInterface $request, array $options)
             );
         }
 
+        // Microsoft NTLM authentication only supported with curl handler
+        if (isset($options['auth'])
+            && is_array($options['auth'])
+            && isset($options['auth'][2])
+            && 'ntlm' == $options['auth'][2]
+        ) {
+
+            throw new \InvalidArgumentException('Microsoft NTLM authentication only supported with curl handler');
+        }
+
         $context = $this->createResource(
             function () use ($context, $params) {
                 return stream_context_create($context, $params);

tests/ClientTest.php

@@ -389,6 +389,18 @@ public function testAuthCanBeArrayForDigestAuth()
         ], $last['curl']);
     }
 
+    public function testAuthCanBeArrayForNtlmAuth()
+    {
+        $mock = new MockHandler([new Response()]);
+        $client = new Client(['handler' => $mock]);
+        $client->get('http://foo.com', ['auth' => ['a', 'b', 'ntlm']]);
+        $last = $mock->getLastOptions();
+        $this->assertEquals([
+            CURLOPT_HTTPAUTH => 8,
+            CURLOPT_USERPWD  => 'a:b'
+        ], $last['curl']);
+    }
+
     public function testAuthCanBeCustomType()
     {
         $mock = new MockHandler([new Response()]);