1 <?php

     2 

     3 /*

     4  * This file is part of the Symfony package.

     5  *

     6  * (c) Fabien Potencier <fabien@symfony.com>

     7  *

     8  * For the full copyright and license information, please view the LICENSE

     9  * file that was distributed with this source code.

    10  */

    11 

    12 namespace Symfony\Component\HttpKernel\Profiler;

    13 

    14 /**

    15  * ProfilerStorageInterface.

    16  *

    17  * @author Fabien Potencier <fabien@symfony.com>

    18  */

    19 interface ProfilerStorageInterface

    20 {

    21     /**

    22      * Finds profiler tokens for the given criteria.

    23      *

    24      * @param string $ip    The IP

    25      * @param string $url   The URL

    26      * @param string $limit The maximum number of tokens to return

    27      *

    28      * @return array An array of tokens

    29      */

    30     function find($ip, $url, $limit);

    31 

    32     /**

    33      * Reads data associated with the given token.

    34      *

    35      * The method returns false if the token does not exists in the storage.

    36      *

    37      * @param string $token A token

    38      *

    39      * @return Profile The profile associated with token

    40      */

    41     function read($token);

    42 

    43     /**

    44      * Write data associated with the given token.

    45      *

    46      * @param Profile $profile A Profile instance

    47      *

    48      * @return Boolean Write operation successful

    49      */

    50     function write(Profile $profile);

    51 

    52     /**

    53      * Purges all data from the database.

    54      */

    55     function purge();

    56 }