aboutsummaryrefslogtreecommitdiffstats
path: root/lib/private/DB/QueryBuilder/QuoteHelper.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/private/DB/QueryBuilder/QuoteHelper.php')
-rw-r--r--lib/private/DB/QueryBuilder/QuoteHelper.php66
1 files changed, 66 insertions, 0 deletions
diff --git a/lib/private/DB/QueryBuilder/QuoteHelper.php b/lib/private/DB/QueryBuilder/QuoteHelper.php
new file mode 100644
index 00000000000..7ce4b359638
--- /dev/null
+++ b/lib/private/DB/QueryBuilder/QuoteHelper.php
@@ -0,0 +1,66 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+namespace OC\DB\QueryBuilder;
+
+use OCP\DB\QueryBuilder\ILiteral;
+use OCP\DB\QueryBuilder\IParameter;
+use OCP\DB\QueryBuilder\IQueryFunction;
+
+class QuoteHelper {
+ /**
+ * @param array|string|ILiteral|IParameter|IQueryFunction $strings string, Literal or Parameter
+ * @return array|string
+ */
+ public function quoteColumnNames($strings) {
+ if (!is_array($strings)) {
+ return $this->quoteColumnName($strings);
+ }
+
+ $return = [];
+ foreach ($strings as $string) {
+ $return[] = $this->quoteColumnName($string);
+ }
+
+ return $return;
+ }
+
+ /**
+ * @param string|ILiteral|IParameter|IQueryFunction $string string, Literal or Parameter
+ * @return string
+ */
+ public function quoteColumnName($string) {
+ if ($string instanceof IParameter || $string instanceof ILiteral || $string instanceof IQueryFunction) {
+ return (string)$string;
+ }
+
+ if ($string === null || $string === 'null' || $string === '*') {
+ return $string;
+ }
+
+ if (!is_string($string)) {
+ throw new \InvalidArgumentException('Only strings, Literals and Parameters are allowed');
+ }
+
+ $string = str_replace(' AS ', ' as ', $string);
+ if (substr_count($string, ' as ')) {
+ return implode(' as ', array_map([$this, 'quoteColumnName'], explode(' as ', $string, 2)));
+ }
+
+ if (substr_count($string, '.')) {
+ [$alias, $columnName] = explode('.', $string, 2);
+
+ if ($columnName === '*') {
+ return '`' . $alias . '`.*';
+ }
+
+ return '`' . $alias . '`.`' . $columnName . '`';
+ }
+
+ return '`' . $string . '`';
+ }
+}