Code Coverage
 
Classes and Traits
Functions and Methods
Lines
Total
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
7 / 7
CRAP
100.00% covered (success)
100.00%
39 / 39
db_text
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
7 / 7
11
100.00% covered (success)
100.00%
39 / 39
 __construct
100.00% covered (success)
100.00%
1 / 1
1
100.00% covered (success)
100.00%
3 / 3
 set
100.00% covered (success)
100.00%
1 / 1
1
100.00% covered (success)
100.00%
2 / 2
 get
100.00% covered (success)
100.00%
1 / 1
2
100.00% covered (success)
100.00%
2 / 2
 delete
100.00% covered (success)
100.00%
1 / 1
1
100.00% covered (success)
100.00%
2 / 2
 set_array
100.00% covered (success)
100.00%
1 / 1
3
100.00% covered (success)
100.00%
17 / 17
 get_array
100.00% covered (success)
100.00%
1 / 1
2
100.00% covered (success)
100.00%
9 / 9
 delete_array
100.00% covered (success)
100.00%
1 / 1
1
100.00% covered (success)
100.00%
4 / 4
<?php
/**
*
* This file is part of the phpBB Forum Software package.
*
* @copyright (c) phpBB Limited <https://www.phpbb.com>
* @license GNU General Public License, version 2 (GPL-2.0)
*
* For full copyright and license information, please see
* the docs/CREDITS.txt file.
*
*/
namespace phpbb\config;
/**
* Manages configuration options with an arbitrary length value stored in a TEXT
* column. In constrast to class \phpbb\config\db, values are never cached and
* prefetched, but every get operation sends a query to the database.
*/
class db_text
{
    /**
    * Database connection
    * @var \phpbb\db\driver\driver_interface
    */
    protected $db;
    /**
    * Name of the database table used.
    * @var string
    */
    protected $table;
    /**
    * @param \phpbb\db\driver\driver_interface $db        Database connection
    * @param string          $table     Table name
    */
    public function __construct(\phpbb\db\driver\driver_interface $db, $table)
    {
        $this->db = $db;
        $this->table = $this->db->sql_escape($table);
    }
    /**
    * Sets the configuration option with the name $key to $value.
    *
    * @param string $key       The configuration option's name
    * @param string $value     New configuration value
    *
    * @return null
    */
    public function set($key, $value)
    {
        $this->set_array(array($key => $value));
    }
    /**
    * Gets the configuration value for the name $key.
    *
    * @param string $key       The configuration option's name
    *
    * @return string|null      String result on success
    *                          null if there is no such option
    */
    public function get($key)
    {
        $map = $this->get_array(array($key));
        return isset($map[$key]) ? $map[$key] : null;
    }
    /**
    * Removes the configuration option with the name $key.
    *
    * @param string $key       The configuration option's name
    *
    * @return null
    */
    public function delete($key)
    {
        $this->delete_array(array($key));
    }
    /**
    * Mass set configuration options: Receives an associative array,
    * treats array keys as configuration option names and associated
    * array values as their configuration option values.
    *
    * @param array $map        Map from configuration names to values
    *
    * @return null
    */
    public function set_array(array $map)
    {
        $this->db->sql_transaction('begin');
        foreach ($map as $key => $value)
        {
            $sql = 'UPDATE ' . $this->table . "
                SET config_value = '" . $this->db->sql_escape($value) . "'
                WHERE config_name = '" . $this->db->sql_escape($key) . "'";
            $this->db->sql_query($sql);
            if (!$this->db->sql_affectedrows())
            {
                $sql = 'INSERT INTO ' . $this->table . ' ' . $this->db->sql_build_array('INSERT', array(
                    'config_name'    => (string) $key,
                    'config_value'    => (string) $value,
                ));
                $this->db->sql_query($sql);
            }
        }
        $this->db->sql_transaction('commit');
    }
    /**
    * Mass get configuration options: Receives a set of configuration
    * option names and returns the result as a key => value map where
    * array keys are configuration option names and array values are
    * associated config option values.
    *
    * @param array $keys       Set of configuration option names
    *
    * @return array            Map from configuration names to values
    */
    public function get_array(array $keys)
    {
        $sql = 'SELECT *
            FROM ' . $this->table . '
            WHERE ' . $this->db->sql_in_set('config_name', $keys, false, true);
        $result = $this->db->sql_query($sql);
        $map = array();
        while ($row = $this->db->sql_fetchrow($result))
        {
            $map[$row['config_name']] = $row['config_value'];
        }
        $this->db->sql_freeresult($result);
        return $map;
    }
    /**
    * Mass delete configuration options.
    *
    * @param array $keys       Set of configuration option names
    *
    * @return null
    */
    public function delete_array(array $keys)
    {
        $sql = 'DELETE
            FROM ' . $this->table . '
            WHERE ' . $this->db->sql_in_set('config_name', $keys, false, true);
        $this->db->sql_query($sql);
    }
}