Subversion Repositories oidplus

Rev

Rev 1117 | Rev 1152 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
786 daniel-mar 1
<?php
2
 
3
/*
4
 * OIDplus 2.0
1086 daniel-mar 5
 * Copyright 2019 - 2023 Daniel Marschall, ViaThinkSoft
786 daniel-mar 6
 *
7
 * Licensed under the Apache License, Version 2.0 (the "License");
8
 * you may not use this file except in compliance with the License.
9
 * You may obtain a copy of the License at
10
 *
11
 *     http://www.apache.org/licenses/LICENSE-2.0
12
 *
13
 * Unless required by applicable law or agreed to in writing, software
14
 * distributed under the License is distributed on an "AS IS" BASIS,
15
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
 * See the License for the specific language governing permissions and
17
 * limitations under the License.
18
 */
19
 
1050 daniel-mar 20
namespace ViaThinkSoft\OIDplus;
786 daniel-mar 21
 
1086 daniel-mar 22
// phpcs:disable PSR1.Files.SideEffects
23
\defined('INSIDE_OIDPLUS') or die;
24
// phpcs:enable PSR1.Files.SideEffects
25
 
786 daniel-mar 26
class OIDplusQueryResultOci extends OIDplusQueryResult {
1130 daniel-mar 27
 
28
        /**
29
         * @var bool
30
         */
786 daniel-mar 31
        protected $no_resultset;
1130 daniel-mar 32
 
33
        /**
34
         * @var mixed
35
         */
786 daniel-mar 36
        protected $res;
37
 
1116 daniel-mar 38
        /**
1130 daniel-mar 39
         * @param mixed $res
1116 daniel-mar 40
         */
786 daniel-mar 41
        public function __construct($res) {
42
                $this->no_resultset = is_bool($res);
43
 
44
                if (!$this->no_resultset) {
45
                        $this->res = $res;
46
                }
47
        }
48
 
1116 daniel-mar 49
        /**
50
         *
51
         */
786 daniel-mar 52
        public function __destruct() {
53
                if ($this->res) {
54
                        oci_free_statement($this->res);
55
                }
56
        }
57
 
1116 daniel-mar 58
        /**
59
         * @return bool
60
         */
786 daniel-mar 61
        public function containsResultSet(): bool {
62
                return !$this->no_resultset;
63
        }
64
 
1116 daniel-mar 65
        /**
66
         * @var ?array
67
         */
786 daniel-mar 68
        private $prefetchedArray = null;
1116 daniel-mar 69
 
70
        /**
71
         * @var int
72
         */
786 daniel-mar 73
        private $countAlreadyFetched = 0;
74
 
1116 daniel-mar 75
        /**
76
         * @return int
77
         * @throws OIDplusException
78
         */
786 daniel-mar 79
        public function num_rows(): int {
80
                if (!is_null($this->prefetchedArray)) {
81
                        return count($this->prefetchedArray) + $this->countAlreadyFetched;
82
                }
83
 
84
                if ($this->no_resultset) throw new OIDplusException(_L('The query has returned no result set (i.e. it was not a SELECT query)'));
85
 
86
                // This function does not return number of rows selected! For SELECT statements this function will return the number of rows, that were fetched to the buffer with oci_fetch*() functions.
87
                //return oci_num_rows($this->res);
88
 
89
                $this->prefetchedArray = array();
90
                oci_fetch_all($this->res, $this->prefetchedArray, 0, -1, OCI_FETCHSTATEMENT_BY_ROW);
91
                return count($this->prefetchedArray) + $this->countAlreadyFetched;
92
        }
93
 
1116 daniel-mar 94
        /**
95
         * @return array|mixed|null
96
         * @throws OIDplusException
97
         */
786 daniel-mar 98
        public function fetch_array()/*: ?array*/ {
99
                if (!is_null($this->prefetchedArray)) {
100
                        $ret = array_shift($this->prefetchedArray);
101
                } else {
102
                        if ($this->no_resultset) throw new OIDplusException(_L('The query has returned no result set (i.e. it was not a SELECT query)'));
103
                        $ret = oci_fetch_array($this->res);
104
                        if ($ret === false) $ret = null;
105
                }
106
                if ($ret) $this->countAlreadyFetched++;
107
 
108
                // Oracle returns $ret['VALUE'] because unquoted column-names are always upper-case
109
                // We can't quote every single column throughout the whole program, so we use this workaround...
110
                if ($ret) {
111
                        $keys = array_keys($ret);
112
                        foreach($keys as $key) {
113
                                $ret[strtolower($key)]=$ret[$key];
114
                                $ret[strtoupper($key)]=$ret[$key];
115
                        }
116
                }
117
 
118
                return $ret;
119
        }
120
 
1116 daniel-mar 121
        /**
1130 daniel-mar 122
         * @param array $ary
1116 daniel-mar 123
         * @return \stdClass
124
         */
1130 daniel-mar 125
        private static function array_to_stdobj(array $ary): \stdClass {
1050 daniel-mar 126
                $obj = new \stdClass;
786 daniel-mar 127
                foreach ($ary as $name => $val) {
128
                        $obj->$name = $val;
129
 
130
                        // Oracle returns $ret['VALUE'] because unquoted column-names are always upper-case
131
                        // We can't quote every single column throughout the whole program, so we use this workaround...
132
                        $name = strtolower($name);
133
                        $obj->$name = $val;
134
                        $name = strtoupper($name);
135
                        $obj->$name = $val;
136
                }
137
                return $obj;
138
        }
139
 
1116 daniel-mar 140
        /**
141
         * @return false|object|\stdClass|null
142
         * @throws OIDplusException
143
         */
786 daniel-mar 144
        public function fetch_object()/*: ?object*/ {
145
                if (!is_null($this->prefetchedArray)) {
146
                        $ary = array_shift($this->prefetchedArray);
147
                        $ret = is_null($ary) ? null : self::array_to_stdobj($ary);
148
                } else {
149
                        if ($this->no_resultset) throw new OIDplusException(_L('The query has returned no result set (i.e. it was not a SELECT query)'));
150
                        $ret = oci_fetch_object($this->res);
151
                        if ($ret === false) $ret = null;
152
                }
153
                if ($ret) $this->countAlreadyFetched++;
154
 
155
                // Oracle returns $ret['VALUE'] because unquoted column-names are always upper-case
156
                // We can't quote every single column throughout the whole program, so we use this workaround...
157
                if ($ret) {
1117 daniel-mar 158
                        foreach ($ret as $name => $val) {
786 daniel-mar 159
                                $ret->{strtoupper($name)} = $val;
160
                                $ret->{strtolower($name)} = $val;
161
                        }
162
                }
163
 
164
                return $ret;
165
        }
166
}