Differences

This shows you the differences between two versions of the page.

--- v5:dictionary:metaforeignkeys [2021/11/08 17:44] – [metaForeignKeys] change default value for $tableName dregad
+++ v5:dictionary:metaforeignkeys [2026/02/26 00:40] (current) – [Return Value] dregad
@@ Line 16: / Line 16: @@
 If specified, only returns foreign keys associated with a table owned by that name. Some drivers discard this parameter
 ==== $upper ====
-if specified, only matches the table with the uppercase name. This parameter is discarded by some drivers
+if specified, the table and columns are returned in uppercase. Default is lowercase.
 ==== $associative====
-If specified, returns the result in associative mode. If ADODB_FETCH_MODE is already associative, then this parameter is discarded. Some drivers ignore this parameter.
+If specified, returns the result in associative mode. If ADODB_FETCH_MODE is already associative, then this parameter is discarded.
 ===== Return Value =====
 The method returns an array of data:
-  *  the main key represents the foreign table that the key associated with.
+  * The main key represents the foreign table that the key associated with.
-  * The values of the key are either a key=>value pair, the key being the column name of the source table and the value being the column name of the foreign table if the request is ''associative'', or a numeric key with value being the same data represented as ''local column'' + '=' + ''foreign column''.
+  * The values of the key are either
+    * a key=>value pair, the key being the column name of the source table and the value being the column name of the foreign table if the request is //associative//, or
+    * a numeric key with value being the same data represented as ''local_column=foreign_column''.
+===== Explanation =====
+A table **//parent_table//** has a foreign key that references **//foreign_table//**. **//parent_table//** has 2 columns **//parent_id//** and **//parent_type//**. These 2 columns reference corresponding columns in **//foreign_table//**, **//foreign_id//** and **//foreign_type//**. ''metaForeignKeys('parent_table')'' presents this data in the following way:
+==== Associative Mode ====
+<code php>
+[
+    ['foreign_table'] [
+        ['parent_id'] => 'foreign_id',
+        ['parent_type'] => 'foreign_type'
+    ]
+]
+</code>
+==== Numeric Mode ====
+<code php>
+[
+    ['foreign_table'] => [
+        [0] => 'parent_id=foreign_id',
+        [1] => 'parent_type=foreign_type'
+    ]
+]
+</code>
 ===== Usage =====
 <code php>