1 <?php

     2 /*

     3  *  $Id$

     4  *

     5  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

     6  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

     7  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

     8  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

     9  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    10  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    11  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

    12  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

    13  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

    14  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

    15  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    16  *

    17  * This software consists of voluntary contributions made by many individuals

    18  * and is licensed under the LGPL. For more information, see

    19  * <http://www.doctrine-project.org>.

    20  */

    21 

    22 namespace Doctrine\DBAL\Logging;

    23 

    24 /**

    25  * Interface for SQL loggers.

    26  *

    27  * @license http://www.opensource.org/licenses/lgpl-license.php LGPL

    28  * @link    www.doctrine-project.org

    29  * @since   2.0

    30  * @version $Revision$

    31  * @author  Benjamin Eberlei <kontakt@beberlei.de>

    32  * @author  Guilherme Blanco <guilhermeblanco@hotmail.com>

    33  * @author  Jonathan Wage <jonwage@gmail.com>

    34  * @author  Roman Borschel <roman@code-factory.org>

    35  */

    36 interface SQLLogger

    37 {

    38     /**

    39      * Logs a SQL statement somewhere.

    40      *

    41      * @param string $sql The SQL to be executed.

    42      * @param array $params The SQL parameters.

    43      * @param array $types The SQL parameter types.

    44      * @return void

    45      */

    46     public function startQuery($sql, array $params = null, array $types = null);

    47 

    48     /**

    49      * Mark the last started query as stopped. This can be used for timing of queries.

    50      *

    51      * @return void

    52      */

    53     public function stopQuery();

    54 }