jamesiarmes / php-ntlm
Library for communicating with Microsoft services using NTLM authentication.
Installs: 1 865 945
Dependents: 6
Suggesters: 0
Security: 0
Stars: 53
Watchers: 3
Forks: 27
Open Issues: 8
Requires
- php: >=5.3.9
- ext-soap: *
This package is auto-updated.
Last update: 2024-10-09 00:46:16 UTC
README
The PHP NTLM library (php-ntlm) is intended to provide various methods to aid in communicating with Microsoft services that utilize NTLM authentication from within PHP.
Dependencies
- Composer
- PHP 8.1
- cURL with NTLM support (7.23.0+ recommended)
Installation
The preferred installation method is via Composer, which will automatically handle autoloading of classes.
{ "require": { "jamesiarmes/php-ntlm": "~1.0" } }
Usage
SoapClient
The \jamesiarmes\PhpNtlm\SoapClient
class extends PHP's built in SoapClient
class and can be used in the same manner with a few minor changes.
- The constructor accepts a required 'user' and 'password' index in the
$options
array. - The constructor accepts an optional 'curlopts' index in the
$options
array that can be used to set or override the default curl options.
Basic example:
$client = new SoapClient( $wsdl, array('user' => 'username', 'password' => '12345') );
Example that skips SSL certificate validation:
$client = new SoapClient( $wsdl, array( 'user' => 'username', 'password' => '12345', 'curlopts' => array(CURLOPT_SSL_VERIFYPEER => false), ) );
Available options
The basic options available on the constructor can be found at http://php.net/manual/en/soapclient.soapclient.php. The trace option is not necessary, as the last request and response methods will always be available. In addition to these options, the following additional options are available:
- user (string, required): The user to authenticate with.
- password (string, required): The password to use when authenticating the user.
- curlopts (array): Array of options to set on the curl handler when making the request. This can be used to override any cURL options with the exception of the following: CURLOPT_HEADER, CURLOPT_POST, CURLOPT_POSTFIELDS.
- strip_bad_chars (boolean, default: true): Whether or not to strip invalid characters from the XML response. This can lead to content being returned differently than it actually is on the host service, but can also prevent the "looks like we got no XML document" SoapFault when the response includes invalid characters.
- warn_on_bad_chars (boolean, default: false): Trigger a warning if bad characters are stripped. This has no affect unless strip_bad_chars is true.
Projects that use php-ntlm
The following is a list of known projects that use this library. If you would like to add your project to the list, please open a pull request to update this document.