SSL context options

SSL context options

SSL context options — SSL context option listing

说明

Context options for ssl:// and tls://transports. 

可选项

verify_peer boolean  

Require verification of SSL certificate used. 

Defaults to FALSE. 

allow_self_signed boolean  

Allow self-signed certificates. Requires verify_peer. 

Defaults to FALSE 

cafile string  

Location of Certificate Authority file on local filesystemwhich should be used with the verify_peercontext option to authenticate the identity of the remote peer. 

capath string  

If cafile is not specified or if the certificateis not found there, the directory pointed to by capath is searched for a suitable certificate. capathmust be a correctly hashed certificate directory. 

local_cert string  

Path to local certificate file on filesystem. It must be a PEMencoded file which contains your certificate and private key.It can optionally contain the certificate chain of issuers. 

passphrase string  

Passphrase with which your local_cert filewas encoded. 

CN_match string  

Common Name we are expecting. PHP will perform limited wildcardmatching. If the Common Name does not match this, the connectionattempt will fail. 

verify_depth integer  

Abort if the certificate chain is too deep. 

Defaults to no verification. 

ciphers string  

Sets the list of available ciphers. The format of the string is describedin » ciphers(1). 

Defaults to DEFAULT. 

capture_peer_cert boolean  

If set to TRUE a peer_certificate context optionwill be created containing the peer certificate. 

capture_peer_cert_chain boolean  

If set to TRUE a peer_certificate_chain contextoption will be created containing the certificate chain. 

SNI_enabled boolean  

If set to TRUE server name indication will be enabled. Enabling SNIallows multiple certificates on the same IP address. 

SNI_server_name string  

If set, then this value will be used as server name for server nameindication. If this value is not set, then the server name is guessedbased on the hostname used when opening the stream. 

disable_compression boolean  

If set, disable TLS compression. This can help mitigate the CRIME attackvector. 

更新日志

版本

说明

5.4.13 Added disable_compression. Requires OpenSSL >= 1.0.0.  

5.3.2 Added SNI_enabled and SNI_server_name.  

5.0.0 Added capture_peer_cert, capture_peer_chain and ciphers.  

注释

Note: Because ssl:// is the underlying transport for the https:// and ftps:// wrappers,any context options which apply to ssl:// also apply to https:// and ftps://.  

Note: For SNI (Server Name Indication) to be available, then PHP must be compiledwith OpenSSL 0.9.8j or greater. Use the OPENSSL_TLSEXT_SERVER_NAME to determine whether SNI issupported.  

参见

◾Socket context options