postgres/lib/Handle.php

<?php

namespace Amp\Postgres;

interface Handle extends Executor {
    /**
     * Indicates if the connection to the database is still alive.
     *
     * @return bool
     */
    public function isAlive(): bool;

    /**
     * Quotes (escapes) the given string for use as a string literal or identifier in a query. This method wraps the
     * string in single quotes, so additional quotes should not be added in the query.
     *
     * @param string $data Unquoted data.
     *
     * @return string Quoted string wrapped in single quotes.
     *
     * @throws \Amp\Postgres\ConnectionException If the connection to the database has been lost.
     */
    public function quoteString(string $data): string;

    /**
     * Quotes (escapes) the given string for use as a name or identifier in a query.
     *
     * @param string $name Unquoted identifier.
     *
     * @return string Quoted identifier.
     *
     * @throws \Amp\Postgres\ConnectionException If the connection to the database has been lost.
     */
    public function quoteName(string $name): string;
}