123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121 |
- <?php
- declare(strict_types=1);
- namespace Doctrine\DBAL\Driver\AbstractOracleDriver;
- use function implode;
- use function is_array;
- use function sprintf;
- /**
- * Represents an Oracle Easy Connect string
- *
- * @link https://docs.oracle.com/database/121/NETAG/naming.htm
- */
- final class EasyConnectString
- {
- /** @var string */
- private $string;
- private function __construct(string $string)
- {
- $this->string = $string;
- }
- public function __toString(): string
- {
- return $this->string;
- }
- /**
- * Creates the object from an array representation
- *
- * @param mixed[] $params
- */
- public static function fromArray(array $params): self
- {
- return new self(self::renderParams($params));
- }
- /**
- * Creates the object from the given DBAL connection parameters.
- *
- * @param mixed[] $params
- */
- public static function fromConnectionParameters(array $params): self
- {
- if (! empty($params['connectstring'])) {
- return new self($params['connectstring']);
- }
- if (empty($params['host'])) {
- return new self($params['dbname'] ?? '');
- }
- $connectData = [];
- if (isset($params['servicename']) || isset($params['dbname'])) {
- $serviceKey = 'SID';
- if (! empty($params['service'])) {
- $serviceKey = 'SERVICE_NAME';
- }
- $serviceName = $params['servicename'] ?? $params['dbname'];
- $connectData[$serviceKey] = $serviceName;
- }
- if (! empty($params['instancename'])) {
- $connectData['INSTANCE_NAME'] = $params['instancename'];
- }
- if (! empty($params['pooled'])) {
- $connectData['SERVER'] = 'POOLED';
- }
- return self::fromArray([
- 'DESCRIPTION' => [
- 'ADDRESS' => [
- 'PROTOCOL' => 'TCP',
- 'HOST' => $params['host'],
- 'PORT' => $params['port'] ?? 1521,
- ],
- 'CONNECT_DATA' => $connectData,
- ],
- ]);
- }
- /**
- * @param mixed[] $params
- */
- private static function renderParams(array $params): string
- {
- $chunks = [];
- foreach ($params as $key => $value) {
- $string = self::renderValue($value);
- if ($string === '') {
- continue;
- }
- $chunks[] = sprintf('(%s=%s)', $key, $string);
- }
- return implode('', $chunks);
- }
- /**
- * @param mixed $value
- */
- private static function renderValue($value): string
- {
- if (is_array($value)) {
- return self::renderParams($value);
- }
- return (string) $value;
- }
- }
|