4.5.5.1 Connection Methods

###
4.5.5.1 Connection Methods

`log_error`( | message[, level])

  An interface to the Apache `ap_log_cerror` function. message is a string with the error message, level is one of the following flags constants:

          APLOG_EMERG
          APLOG_ALERT
          APLOG_CRIT
          APLOG_ERR
          APLOG_WARNING
          APLOG_NOTICE
          APLOG_INFO
          APLOG_DEBUG
          APLOG_NOERRNO

  If you need to write to log and do not have a reference to a connection or request object, use the `apache.log_error` function.

`read`( | [length])

  Reads at most length bytes from the client. The read blocks indefinitely until there is at least one byte to read. If length is -1, keep reading until the socket is closed from the other end (This is known as `EXHAUSTIVE` mode in the http server code).

  This method should only be used inside Connection Handlers.

  Note: The behaviour of this method has changed since version 3.0.3. In 3.0.3 and prior, this method would block until length bytes was read.

`readline`( | [length])

  Reads a line from the connection or up to length bytes.

  This method should only be used inside Connection Handlers.

`write`( | string)

  Writes string to the client.

  This method should only be used inside Connection Handlers.