Spec-Zone.ru › CakePHP 2.9

Класс CakeSocket

Класс CakePHP для сетевых сокетов.

Базовый класс ядра для сетевого взаимодействия.

Прямые подклассы

  • HttpSocket
Пакет: Cake\Network
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Network/CakeSocket.php

Резюме свойств

  • $_baseConfig protected
    array
    Базовые параметры конфигурации для подключения к сокету
  • $_connectionErrors protected
    array

    Используется для захвата предупреждений о подключении, которые могут возникать при наличии ошибок SSL, например.

  • $_encryptMethods protected
    array
    Содержит все доступные методы шифрования
  • $config public
    array
    Параметры конфигурации для подключения к сокету
  • $connected public
    boolean
    Это логическое значение содержит текущее состояние класса CakeSocket
  • $connection public
    resource
    Ссылка на ресурс подключения к сокету
  • $description public
    string
    Описание CakeSocket
  • $encrypted public
    boolean
    Истина, если поток сокета зашифрован после вызова CakeSocket::enableCrypto()
  • $lastError public
    array
    Эта переменная содержит массив с последним номером ошибки (num) и строкой (str)

Резюме методов

  • __construct() public
    Конструктор.
  • __destruct() public
    Деструктор, используется для отключения от текущего подключения.
  • _connectionErrorHandler() protected

    socket_stream_client() не заполняет errNum или $errStr при возникновении ошибок подключения, например, при отказе проверки SSL.

  • _setSslContext() protected
    Настройка параметров контекста SSL.
  • address() public
    Получение IP-адреса текущего подключения.
  • addresses() public
    Получение всех IP-адресов, связанных с текущим подключением.
  • connect() public
    Подключение сокета к указанному хосту и порту.
  • context() public
    Получение контекста подключения.
  • disconnect() public
    Отключение сокета от текущего подключения.
  • enableCrypto() public
    Шифрование текущего потока сокета, используя один из определенных методов шифрования.
  • host() public
    Получение имени хоста текущего подключения.
  • lastError() public
    Получение последней ошибки в виде строки.
  • read() public

    Чтение данных из сокета. Возвращает false, если данные недоступны или подключение не может быть установлено.

  • reset() public
    Сброс состояния экземпляра этого сокета в начальное состояние (до выполнения CakeObject::__construct)
  • setLastError() public
    Установка последней ошибки.
  • write() public
    Запись данных в сокет.

Подробности метода

__construct()source public

__construct( array $config array() )

Конструктор.

Параметры

массив $config необязательно array()
Конфигурация сокета, которая будет объединена с базовой конфигурацией

См. также

CakeSocket::$_baseConfig

__destruct()source public

__destruct( )

Деструктор, используется для отключения от текущего подключения.

_connectionErrorHandler()source protected

_connectionErrorHandler( integer $code , string $message )

socket_stream_client() не заполняет errNum или $errStr при возникновении ошибок подключения, например, при отказе проверки SSL.

Вместо этого нам необходимо обработать эти ошибки вручную.

Параметры

целое число $code
Код.
строка $message
Сообщение.

_setSslContext()source protected

_setSslContext( string $host )

Настройка параметров контекста SSL.

Параметры

строка $host
Имя хоста, к которому осуществляется подключение.

address()source public

address( )

Получение IP-адреса текущего подключения.

Возвращает

строка
IP-адрес

addresses()source public

addresses( )

Получение всех IP-адресов, связанных с текущим подключением.

Возвращает

массив
IP-адреса

connect()source public

connect( )

Подключение сокета к указанному хосту и порту.

Возвращает

логическое значение
Успех

Вызывает

SocketException

context()source public

context( )

Получение контекста подключения.

Возвращает

null|массив
Null, если подключения нет, массив в случае наличия.

disconnect()source public

disconnect( )

Отключение сокета от текущего подключения.

Возвращает

логическое значение
Успех

enableCrypto()source public

enableCrypto( string $type , string $clientOrServer 'client' , boolean $enable true )

Шифрование текущего потока сокета, используя один из определенных методов шифрования.

Параметры

строка $type
Тип, который может быть одним из 'sslv2', 'sslv3', 'sslv23' или 'tls'.
строка $clientOrServer необязательно 'client'
Может быть одним из 'client', 'server'. По умолчанию 'client'.
логическое значение $enable необязательно true
Включить или отключить шифрование. По умолчанию включено (true).

Возвращает

логическое значение
True в случае успеха

Вызывает

InvalidArgumentException
При выборе неверной схемы шифрования.
SocketException
При попытке включения SSL/TLS.

См. также

stream_socket_enable_crypto

host()source public

host( )

Получение имени хоста текущего подключения.

Возвращает

строка
Имя хоста
END_OF_DOCUMENT_MARKER

lastError()source public

lastError( )

Получает последнюю ошибку в виде строки.

Возвращаемое значение

string|null
Последняя ошибка

read()source public

read( integer $length 1024 )

Считывает данные из сокета. Возвращает false, если данные недоступны или соединение не может быть установлено.

Параметры

integer $length необязательный 1024
Необязательная длина буфера для чтения; по умолчанию 1024

Возвращаемое значение

mixed
Данные сокета

reset()source public

reset( array $state null )

Сбрасывает состояние этого экземпляра Socket до его начального состояния (до выполнения CakeObject::__construct)

Параметры

array $state необязательный null
Массив с ключами и значениями для сброса

Возвращаемое значение

boolean
True при успехе

setLastError()source public

setLastError( integer $errNum , string $errStr )

Устанавливает последнюю ошибку.

Параметры

integer $errNum
Код ошибки
string $errStr
Строка ошибки

write()source public

write( string $data )

Записывает данные в сокет.

Параметры

string $data
Данные для записи в сокет

Возвращаемое значение

boolean
Успех

Подробное описание свойств

$_baseConfigsource

protected array

Базовые параметры конфигурации для подключения к сокету

array(
    'persistent' => false,
    'host' => 'localhost',
    'protocol' => 'tcp',
    'port' => 80,
    'timeout' => 30
)

$_connectionErrorssource

protected array

Используется для захвата предупреждений о подключении, которые могут возникнуть, например, при ошибках SSL.

array()

$_encryptMethodssource

protected array

Содержит все доступные методы шифрования

array(
    // @codingStandardsIgnoreStart
    'sslv2_client' => STREAM_CRYPTO_METHOD_SSLv2_CLIENT,
    'sslv3_client' => STREAM_CRYPTO_METHOD_SSLv3_CLIENT,
    'sslv23_client' => STREAM_CRYPTO_METHOD_SSLv23_CLIENT,
    'tls_client' => STREAM_CRYPTO_METHOD_TLS_CLIENT,
    'sslv2_server' => STREAM_CRYPTO_METHOD_SSLv2_SERVER,
    'sslv3_server' => STREAM_CRYPTO_METHOD_SSLv3_SERVER,
    'sslv23_server' => STREAM_CRYPTO_METHOD_SSLv23_SERVER,
    'tls_server' => STREAM_CRYPTO_METHOD_TLS_SERVER
    // @codingStandardsIgnoreEnd
)

$configsource

public array

Настройки конфигурации для подключения к сокету

array()

$connectedsource

public boolean

Это булево значение содержит текущее состояние класса CakeSocket

false

$connectionsource

public resource

Ссылка на ресурс подключения к сокету

null

$descriptionsource

public string

Описание CakeSocket

'Remote DataSource Network Socket Interface'

$encryptedsource

public boolean

True, если поток сокета зашифрован после вызова CakeSocket::enableCrypto()

false

$lastErrorsource

public array

Эта переменная содержит массив с последним номером ошибки (num) и строкой ошибки (str)

array()

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.9/class-CakeSocket.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API