UpdateDatabase/MysqlLinks.php
[Pman.Core] / UpdateDatabase / MysqlLinks.php
1 <?php
2 /**
3  * our standard code relies on links.ini files for the relationships in mysql.
4  *
5  * as we use 'loose' relationships - eg. we allow '0' as a missing link mysql FORIEGN KEYS do not really work.
6  *
7  * There are a couple of ideas behind this code.
8  *
9  * a) put the relationships in the table comments FK(col=table:col,col=table:col)
10  *  -- we can not put it in the column comments as there is no clean way to update column comments.
11  *  -- This can be used by external programs to extract the Relationships.
12  *
13  * b) generate triggers? to protect against updates to the database..
14  *
15  *  -- stored procedures are named
16  *     {tablename}_before_{insert|delete|update}
17  *     
18  *  
19  *   initial code will auto generate triggers
20  *   -- how to add User defined modifications to triggers?
21  *   -- we can CALL a stored procedure..?
22  *   -- {tablename}_trigger_{optional_string}_before_delete_{column_name}(NEW.column)
23  *   -- {tablename}_trigger_{optional_string}_before_update_{column_name}(OLD.column, NEW.column}
24  *   -- {tablename}_trigger_{optional_string}_before_insert_{column_name}(OLD.column}
25  *
26  *  
27  *
28  */
29
30 class Pman_Core_UpdateDatabase_MysqlLinks {
31     
32     var $dburl;
33     var $schema;
34     var $links;
35     
36     function __construct()
37     {
38           
39         $this->loadIniFiles();
40         $this->updateTableComments();
41         $ff = HTML_FlexyFramework::get();
42         if (!empty($ff->Pman['enable_trigger_tests'])) {
43             
44             // note we may want to override some of these... - to do special triggers..
45             // as you can only have one trigger per table for each action.
46             
47             $this->createDeleteTriggers();
48             $this->createInsertTriggers();
49             $this->createUpdateTriggers();
50         }
51         
52         
53     }
54     
55     function loadIniFiles()
56     {
57         // will create the combined ini cache file for the running user.
58         
59         $ff = HTML_FlexyFramework::get();
60         $ff->generateDataobjectsCache(true);
61         $this->dburl = parse_url($ff->database);
62         
63         $dbini = 'ini_'. basename($this->dburl['path']);
64         
65         
66         $iniCache = $ff->DB_DataObject[$dbini];
67         
68         $this->schema = parse_ini_file($iniCache, true);
69         $this->links = parse_ini_file(preg_replace('/\.ini$/', '.links.ini', $iniCache), true);
70         
71
72         
73     }
74     function updateTableComments()
75     {
76         foreach($this->links as $tbl =>$map) {
77             $this->updateTableComment($tbl, $map);
78             
79         }
80         
81         
82     }
83     
84     function updateTableComment($tbl, $map)
85     {
86          
87         
88         if (!isset($this->schema[$tbl])) {
89             echo "Skip $tbl = table does not exist in schema\n";
90             return;
91         }
92         
93         
94         $q = DB_DAtaObject::factory('core_enum');
95         $q->query("SELECT
96                      TABLE_COMMENT
97                     FROM
98                         information_schema.TABLES
99                     WHERE
100                         TABLE_SCHEMA = '{$q->escape($q->database())}'
101                         AND
102                         TABLE_NAME = '{$q->escape($tbl)}'
103         ");
104         $q->fetch();
105         $tc = $q->TABLE_COMMENT;
106         //echo "$tbl: $tc\n\n";
107         if (!empty($q->TABLE_COMMENT)) {
108             //var_dump($tc);
109             $tc = trim(preg_replace('/FK\([^)]+\)/', '' , $q->TABLE_COMMENT));
110             //var_dump($tc);exit;
111             // strip out the old FC(....) 
112                         
113         }
114         $fks = array();
115         foreach($map as $k=>$v) {
116             $fks[] = "$k=$v";
117         }
118         $fkstr = $tc . ' FK(' . implode("\n", $fks) .')';
119         if ($q->TABLE_COMMENT == $fkstr) {
120             return;
121         }
122         
123         $q = DB_DAtaObject::factory('core_enum');
124         $q->query("ALTER TABLE $tbl COMMENT = '{$q->escape($fkstr)}'");
125         
126         
127         
128     }
129     
130     function createDeleteTriggers()
131     {
132         
133         // this should only be enabled if the project settings are configured..
134         
135        
136         
137         // delete triggers on targets -
138         // if you delete a company, and a person points to it, then it should fire an error...
139         
140         
141         
142         
143         // create a list of source/targets from $this->links
144         print_R($this->links);exit;
145         
146         $revmap = array();
147         foreach($this->links as $tbl => $map) {
148             if (!isset($this->schema[$tbl])) {
149                 continue;
150             }
151             foreach($map as $k =>$v) {
152                 list ($tname, $tcol) = explode(':', $v);
153                 
154                 
155                 if (!isset($revmap[$tname])) {
156                     $revmap[$tname] = array();
157                 }
158                 $revmap[$tname]["$tbl:$k"] = "$tname:$tcol";
159             }
160         }
161         
162         
163         
164         
165         foreach($revmap as $target_table => $sources) {
166             
167             
168             // throw example.. UPDATE `Error: invalid_id_test` SET x=1;
169             
170             if (!isset($this->schema[$target_table])) {
171                 echo "Skip $target_table  = table does not exist in schema\n";
172                 return;
173             }
174         
175             
176             
177             $q = DB_DataObject::factory('core_enum');
178             $q->query("
179                 DROP TRIGGER IF EXISTS `{$target_table}_before_delete` ;
180             ");
181             
182             $trigger = "
183              
184             CREATE TRIGGER `{$target_table}_before_delete`
185                 BEFORE DELETE ON `{$target_table}`
186             FOR EACH ROW
187             BEGIN
188                DECLARE mid INT(11);
189              
190                
191             ";
192             foreach($sources as $source=>$target) {
193                 list($source_table , $source_col) = explode(':', $source);
194                 list($target_table , $target_col) = explode(':', $target);
195                 $err = substr("Failed Delete {$target_table} refs {$source_table}:{$source_col}", 0, 64);
196                 $trigger .="
197                     SET mid = 0;
198                     SELECT count(*) into mid FROM {$source_table} WHERE {$source_col} = OLD.{$target_col} LIMIT 1;
199                     IF mid > 0 THEN
200                        
201                        UPDATE `$err` SET x = 1;
202                        
203                     END IF;
204                 ";
205             }
206             
207             $ar = $this->listTriggerFunctions($tbl, 'delete');
208             foreach($ar as $fn=>$col) {
209                 $trigger .= "
210                     CALL $fn( OLD.{$col});
211                 ";
212             }
213             
214             $trigger .= "
215             END 
216            
217             ";
218             
219             //DB_DAtaObject::debugLevel(1);
220             $q = DB_DataObject::factory('core_enum');
221             $q->query($trigger);
222              echo "CREATED TRIGGER {$target_table}_before_delete\n";
223         }
224         
225         
226         // inserting - row should not point to a reference that does not exist...
227         
228         
229         
230         
231     }
232     function createInsertTriggers()
233     {
234         foreach($this->links as $tbl => $map) {
235             if (!isset($this->schema[$tbl])) {
236                 continue;
237             }
238             
239             $q = DB_DataObject::factory('core_enum');
240             $q->query("
241                 DROP TRIGGER IF EXISTS `{$tbl}_before_insert` ;
242             ");
243             
244             $trigger = "
245              
246             CREATE TRIGGER `{$tbl}_before_insert`
247                 BEFORE INSERT ON `{$tbl}`
248             FOR EACH ROW
249             BEGIN
250                DECLARE mid INT(11);
251                
252                
253             ";
254             foreach($map as $source_col=>$target) {
255                 // check that source_col exists in schema.
256                 if (!isset($this->schema[$tbl][$source_col])) {
257                     continue;
258                 }
259                 
260                 
261                 $source_tbl = $tbl;
262                 list($target_table , $target_col) = explode(':', $target);
263                 $err = substr("Fail: INSERT referenced {$tbl}:{$source_col}", 0, 64);
264                 $trigger .="
265                     SET mid = 0;
266                     if NEW.{$source_col} > 0 THEN
267                         SELECT {$target_col} into mid FROM {$target_table} WHERE {$target_col} = NEW.{$source_col} LIMIT 1;
268                         IF mid < 1 THEN
269                             UPDATE `$err` SET x = 1;
270                         END IF;
271                        
272                     END IF;
273                 ";
274                 
275                 
276                 
277             }
278             $ar = $this->listTriggerFunctions($tbl, 'insert');
279             foreach($ar as $fn=>$col) {
280                 $trigger .= "
281                     CALL $fn( NEW.{$col});
282                 ";
283             }
284             
285             $trigger .= "
286             END 
287            
288             ";
289             //echo $trigger; exit;
290             //DB_DAtaObject::debugLevel(1);
291             $q = DB_DataObject::factory('core_enum');
292             $q->query($trigger);
293             echo "CREATED TRIGGER {$tbl}_before_insert\n";
294             
295             
296             
297             
298             
299             
300             
301         }
302         
303         
304         
305     }
306      function createUpdateTriggers()
307     {
308         foreach($this->links as $tbl => $map) {
309             if (!isset($this->schema[$tbl])) {
310                 continue;
311             }
312             
313             $q = DB_DataObject::factory('core_enum');
314             $q->query("
315                 DROP TRIGGER IF EXISTS `{$tbl}_before_update` ;
316             ");
317             
318             $trigger = "
319              
320             CREATE TRIGGER `{$tbl}_before_update`
321                 BEFORE UPDATE ON `{$tbl}`
322             FOR EACH ROW
323             BEGIN
324                DECLARE mid INT(11);
325                
326                
327             ";
328             foreach($map as $source_col=>$target) {
329                 // check that source_col exists in schema.
330                 if (!isset($this->schema[$tbl][$source_col])) {
331                     continue;
332                 }
333                 
334                 
335                 $source_tbl = $tbl;
336                 list($target_table , $target_col) = explode(':', $target);
337                 $err = substr("Fail: UPDATE referenced {$tbl}:$source_col", 0, 64);
338                 $trigger .="
339                     SET mid = 0;
340                     if NEW.{$source_col} > 0 THEN
341                         SELECT {$target_col} into mid FROM {$target_table} WHERE {$target_col} = NEW.{$source_col} LIMIT 1;
342                         IF mid < 1 THEN
343                             UPDATE `$err` SET x = 1;
344                         END IF;
345                        
346                     END IF;
347                 ";
348             }
349             $ar = $this->listTriggerFunctions($tbl, 'update');
350             foreach($ar as $fn=>$col) {
351                 $trigger .= "
352                     CALL $fn(OLD.{$col}, NEW.{$col});
353                 ";
354             }
355             
356             $trigger .= "
357             END 
358            
359             ";
360             //echo $trigger; exit;
361             //DB_DAtaObject::debugLevel(1);
362             $q = DB_DataObject::factory('core_enum');
363             $q->query($trigger);
364             echo "CREATED TRIGGER {$tbl}_before_update\n";
365             
366             
367             
368             
369             
370             
371             
372         }
373         
374         
375         
376     }
377     /**
378      * check the information schema for any methods that match the trigger criteria.
379      *   -- {tablename}_trigger_{optional_string}_before_delete_{column_name}(NEW.column)
380      *   -- {tablename}_trigger_{optional_string}_before_update_{column_name}(OLD.column, NEW.column}
381      *   -- {tablename}_trigger_{optional_string}_before_insert_{column_name}(OLD.column}
382      *
383      *
384      */
385     // type = update/insert/delete
386     
387     function listTriggerFunctions($table, $type)
388     {
389         static $cache = array();
390         if (!isset($cache[$table])) {
391             $cache[$table] = array();
392             $q = DB_DAtaObject::factory('core_enum');
393             $q->query("SELECT
394                             SPECIFIC_NAME
395                         FROM
396                             information_schema.ROUTINES
397                         WHERE
398                             ROUTINE_SCHEMA = '{$q->escape($q->database())}'
399                             AND
400                             ROUTINE_NAME LIKE '" . $q->escape("{$table}_trigger_")  . "%'
401                             AND
402                             ROUTINE_TYPE = 'PROCEDURE'
403                             
404             ");
405             while ($q->fetch()) {
406                 $cache[$table][] = $q->SPECIFIC_NAME;
407             }
408             
409         }
410         // now see which of the procedures match the specification..
411         $ret = array();
412         foreach($cache[$table] as $cname) {
413             $bits = explode("_before_{$type}_", $cname);
414             if (count($bits) < 2) {
415                 continue;
416             }
417             $ret[$cname] = $bits[1];
418         }
419         return $ret;
420     }
421         
422     
423 }
424