CoreFiles by mySites.guru
DatabaseconnectionField.php83 lines, 2,435 bytes, from Joomla_4.2.2-Stable-Full_Package.zip
Raw History Compare with 4.2.1
md5
f23e92adc34f63d3a6571fa8ca15c745
sha1
3963a27e7adfa83fe3dfe5a08e93999167613508
sha256
98d141e43940329dc5e78991d3d4d632b0f6fa7f4489395e411ecce9ef03c3d5
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2011 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Form\Field;

use Joomla\CMS\Language\Text;
use Joomla\Database\DatabaseDriver;

// phpcs:disable PSR1.Files.SideEffects
\defined('JPATH_PLATFORM') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Form Field class for the Joomla Platform.
 * Provides a list of available database connections, optionally limiting to
 * a given list.
 *
 * @see    DatabaseDriver
 * @since  1.7.3
 */
class DatabaseconnectionField extends ListField
{
    /**
     * The form field type.
     *
     * @var    string
     * @since  1.7.3
     */
    protected $type = 'Databaseconnection';

    /**
     * Method to get the list of database options.
     *
     * This method produces a drop down list of available databases supported
     * by DatabaseDriver classes that are also supported by the application.
     *
     * @return  array  The field option objects.
     *
     * @since   1.7.3
     * @see     DatabaseDriver::getConnectors()
     */
    protected function getOptions()
    {
        // This gets the connectors available in the platform and supported by the server.
        $available = array_map('strtolower', DatabaseDriver::getConnectors());

        /**
         * This gets the list of database types supported by the application.
         * This should be entered in the form definition as a comma separated list.
         * If no supported databases are listed, it is assumed all available databases
         * are supported.
         */
        $supported = $this->element['supported'];

        if (!empty($supported)) {
            $supported = explode(',', $supported);

            foreach ($supported as $support) {
                if (\in_array($support, $available)) {
                    $options[$support] = Text::_(ucfirst($support));
                }
            }
        } else {
            foreach ($available as $support) {
                $options[$support] = Text::_(ucfirst($support));
            }
        }

        // This will come into play if an application is installed that requires
        // a database that is not available on the server.
        if (empty($options)) {
            $options[''] = Text::_('JNONE');
        }

        return $options;
    }
}

The same content is in 17 releases, Joomla 4.2.1 to 4.3.0-alpha3. See them all, or every version of this file.