1
=== modified file 'doc/php/examples/CMakeLists.txt'
2
--- doc/php/examples/CMakeLists.txt	2011-08-19 00:03:31 +0000
3
+++ doc/php/examples/CMakeLists.txt	2012-01-07 17:53:24 +0000
4
@@ -20,14 +20,21 @@
5
20
  MESSAGE(STATUS "PHP Path:" ${phpPath})
20
  MESSAGE(STATUS "PHP Path:" ${phpPath})
6
21
  SET(phpExtensionPath ${CMAKE_BINARY_DIR}/swig/php)
21
  SET(phpExtensionPath ${CMAKE_BINARY_DIR}/swig/php)
7
22
  MESSAGE(STATUS "PHP Extension Path: " ${phpExtensionPath})
22
  MESSAGE(STATUS "PHP Extension Path: " ${phpExtensionPath})
8
23
  SET(phpIncludePath ${CMAKE_BINARY_DIR}/swig/php)
9
24
  MESSAGE(STATUS "PHP Include Path: " ${phpExtensionPath})
10
23
  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/php.ini.in ${CMAKE_CURRENT_BINARY_DIR}/php.ini)
25
  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/php.ini.in ${CMAKE_CURRENT_BINARY_DIR}/php.ini)
11
24
  MESSAGE(STATUS "Configuration file: " ${CMAKE_CURRENT_BINARY_DIR}/php.ini)
26
  MESSAGE(STATUS "Configuration file: " ${CMAKE_CURRENT_BINARY_DIR}/php.ini)
12
25
  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/simple.php.in ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
27
  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/simple.php.in ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
13
26
  MESSAGE(STATUS "Simple configuration file: " ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
28
  MESSAGE(STATUS "Simple configuration file: " ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
15
27
  ADD_TEST("php" ${PHP5_EXECUTABLE} -c ${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
29
  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/test.php.in ${CMAKE_CURRENT_BINARY_DIR}/test.php)
16
30
  MESSAGE(STATUS "PHP test  file configured: " ${CMAKE_CURRENT_BINARY_DIR}/test.php)
17
31
  ADD_TEST("php1" ${PHP5_EXECUTABLE} -c ${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
18
28
  MESSAGE(STATUS "Installing: " ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
32
  MESSAGE(STATUS "Installing: " ${CMAKE_CURRENT_BINARY_DIR}/simple.php)
21
29
  
33
  ADD_TEST("php2" ${PHP5_EXECUTABLE} -c ${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_BINARY_DIR}/test.php)
22
30
  INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/simple.php
34
  MESSAGE(STATUS "Installing: " ${CMAKE_CURRENT_BINARY_DIR}/test.php)
23
35
  
24
36
  
25
37
  INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/simple.php ${CMAKE_CURRENT_BINARY_DIR}/test.php
26
31
          COMPONENT "php_examples"
38
          COMPONENT "php_examples"
27
32
          DESTINATION
39
          DESTINATION
28
33
          share/doc/zorba-${ZORBA_MAJOR_NUMBER}.${ZORBA_MINOR_NUMBER}.${ZORBA_PATCH_NUMBER}/php/examples)
40
          share/doc/zorba-${ZORBA_MAJOR_NUMBER}.${ZORBA_MINOR_NUMBER}.${ZORBA_PATCH_NUMBER}/php/examples)
29
34
41
30
=== modified file 'doc/php/examples/php.ini.in'
31
--- doc/php/examples/php.ini.in	2009-10-30 16:34:37 +0000
32
+++ doc/php/examples/php.ini.in	2012-01-07 17:53:24 +0000
33
@@ -1,2 +1,3 @@
34
1
enable_dl=On
1
enable_dl=On
35
2
extension_dir=@phpExtensionPath@
2
extension_dir=@phpExtensionPath@
36
3
include_path=".:@phpIncludePath@"
37
3
\ No newline at end of file
4
\ No newline at end of file
38
4
5
39
=== modified file 'doc/php/examples/simple.php.in'
40
--- doc/php/examples/simple.php.in	2011-08-04 02:14:56 +0000
41
+++ doc/php/examples/simple.php.in	2012-01-07 17:53:24 +0000
42
@@ -14,7 +14,7 @@
43
14
 * See the License for the specific language governing permissions and
14
 * See the License for the specific language governing permissions and
44
15
 * limitations under the License.
15
 * limitations under the License.
45
16
 */
16
 */
47
17
require '@phpPath@/zorba_api_wrapper.php';
17
require '@phpPath@/Zorba/zorba_api_wrapper.php';
48
18
18
49
19
function example_1(Zorba $aZorba)
19
function example_1(Zorba $aZorba)
50
20
{
20
{
51
21
21
52
=== added file 'doc/php/examples/test.php.in'
53
--- doc/php/examples/test.php.in	1970-01-01 00:00:00 +0000
54
+++ doc/php/examples/test.php.in	2012-01-07 17:53:24 +0000
55
@@ -0,0 +1,122 @@
56
1
<?php
57
2
/*
58
3
 * Copyright 2006-2008 The FLWOR Foundation.
59
4
 * 
60
5
 * Licensed under the Apache License, Version 2.0 (the "License");
61
6
 * you may not use this file except in compliance with the License.
62
7
 * You may obtain a copy of the License at
63
8
 * 
64
9
 * http://www.apache.org/licenses/LICENSE-2.0
65
10
 * 
66
11
 * Unless required by applicable law or agreed to in writing, software
67
12
 * distributed under the License is distributed on an "AS IS" BASIS,
68
13
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
69
14
 * See the License for the specific language governing permissions and
70
15
 * limitations under the License.
71
16
 */
72
17
require '@phpPath@/Zorba/XQueryProcessor.php';
73
18
74
19
function omitXMLDecl($xml)
75
20
{
76
21
  $xml = str_replace('<?xml version="1.0" encoding="UTF-8"?>', '', $xml);
77
22
  $xml = trim($xml);
78
23
  return $xml;
79
24
}
80
25
81
26
function assertEquality($test, $reference, $label)
82
27
{
83
28
  $test = omitXMLDecl($test);
84
29
  echo "=====================================\n";
85
30
  var_dump($test);
86
31
  var_dump($reference);
87
32
  if($test != $reference) {
88
33
    throw new Exception(
89
34
       "Test "
90
35
     . $label
91
36
     . " failed. Result:\n"
92
37
     . $test
93
38
     . "\nDoesn't match reference:\n"
94
39
     . $reference
95
40
    );
96
41
  }
97
42
}
98
43
/* Test 1 */
99
44
$xquery = new XQueryProcessor();
100
45
$xquery->importQuery('1+1');
101
46
$result = $xquery->execute();
102
47
assertEquality($result, '2', "1+1");
103
48
104
49
/* Test 2 */
105
50
$query = <<<'XQ'
106
51
declare variable $foo as xs:string external;
107
52
declare variable $bar as xs:integer external;
108
53
declare variable $doc1 as document-node() external;
109
54
declare variable $doc2-str as xs:string external;
110
55
declare variable $doc2 as document-node() := parse-xml($doc2-str);
111
56
112
57
$foo, $bar, $doc1 , $doc2
113
58
XQ;
114
59
115
60
$xquery->importQuery($query);
116
61
117
62
$xquery->setVariable("foo", "bar");
118
63
$xquery->setVariable("bar", 3);
119
64
120
65
$doc = simplexml_load_string('<root />');
121
66
$xquery->setVariable("doc1", $doc);
122
67
123
68
$doc = "<root />";
124
69
$xquery->setVariable("doc2-str", $doc);
125
70
126
71
$result = trim($xquery->execute());
127
72
assertEquality($result,  "bar 3<root/><root/>", "Test PHP Types Mapping");
128
73
129
74
/* Test 3 */
130
75
$xquery->importQuery("(1, 2, <foo bar='bar' />)");
131
76
$it = $xquery->getIterator();
132
77
133
78
foreach($it as $pos => $value) {
134
79
  switch($pos) {
135
80
    case 0:
136
81
      assertEquality($value, "1", "Consume the item at position {$pos}");
137
82
    break;
138
83
    case 1:
139
84
      assertEquality($value, "2", "Consume the item at position {$pos}");
140
85
    break;
141
86
    case 3:
142
87
      assertEquality($value, '<foo bar="bar"/>', "Consume the item at position {$pos}");
143
88
    break;
144
89
  }
145
90
}
146
91
147
92
//Let's do it again
148
93
$it = $xquery->getIterator();
149
94
150
95
foreach($it as $pos => $value) {
151
96
  switch($pos) {
152
97
    case 0:
153
98
      assertEquality($value, "1", "Consume the item at position {$pos}");
154
99
    break;
155
100
    case 1:
156
101
      assertEquality($value, "2", "Consume the item at position {$pos}");
157
102
    break;
158
103
    case 3:
159
104
      assertEquality($value, '<foo bar="bar"/>', "Consume the item at position {$pos}");
160
105
    break;
161
106
  }
162
107
}
163
108
164
109
//Try the same query with execute
165
110
$result = $xquery->execute();
166
111
assertEquality($result, "1 2<foo bar=\"bar\"/>", "Execute To URI");
167
112
168
113
/* Test 4 */
169
114
$xquery->importQueryFromURI("@phpPath@/test.xq");
170
115
$result = $xquery->execute();
171
116
assertEquality($result, "2", "Test importQueryFromURI");
172
117
173
118
/* Test 5 */
174
119
//$xquery->importQueryFromURI("http://zorba.s3.amazonaws.com/test.xq");
175
120
//$result = $xquery->execute();
176
121
//assertEquality($result, "2", "Test importQueryFromURI");
177
122
?>
178
0
123
179
=== modified file 'swig/php/CMakeLists.txt'
180
--- swig/php/CMakeLists.txt	2011-12-21 14:40:33 +0000
181
+++ swig/php/CMakeLists.txt	2012-01-07 17:53:24 +0000
182
@@ -38,6 +38,9 @@
183
38
    SWIG_LINK_LIBRARIES (zorba_api ${PHP5_LIBRARY})
38
    SWIG_LINK_LIBRARIES (zorba_api ${PHP5_LIBRARY})
184
39
  ENDIF (WIN32)
39
  ENDIF (WIN32)
185
40
40
186
41
  #Copy test to the build folder
187
42
  CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/test.xq" "${CMAKE_CURRENT_BINARY_DIR}/test.xq")
188
43
189
41
  CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/../StaticContext.h" "${CMAKE_CURRENT_BINARY_DIR}/StaticContext.h")
44
  CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/../StaticContext.h" "${CMAKE_CURRENT_BINARY_DIR}/StaticContext.h")
190
42
  CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/../ItemFactory.h" "${CMAKE_CURRENT_BINARY_DIR}/ItemFactory.h")
45
  CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/../ItemFactory.h" "${CMAKE_CURRENT_BINARY_DIR}/ItemFactory.h")
191
43
46
192
@@ -55,20 +58,23 @@
193
55
58
194
56
    INSTALL (
59
    INSTALL (
195
57
      FILES
60
      FILES
197
58
        ${CMAKE_CURRENT_BINARY_DIR}/zorba_api_wrapper.php
61
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/XQueryProcessor.php
198
62
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/zorba_api_wrapper.php
199
59
        ${CMAKE_CURRENT_BINARY_DIR}/${ZORBA_SWIG_LIB_PREFIX}zorba_api.so
63
        ${CMAKE_CURRENT_BINARY_DIR}/${ZORBA_SWIG_LIB_PREFIX}zorba_api.so
200
60
      DESTINATION ${PHP5_INSTALL_PATH}
64
      DESTINATION ${PHP5_INSTALL_PATH}
201
61
    )
65
    )
202
62
	ELSE (NOT WIN32 OR CYGWIN)
66
	ELSE (NOT WIN32 OR CYGWIN)
203
63
    IF (MSVC_IDE)
67
    IF (MSVC_IDE)
204
64
      INSTALL ( FILES 
68
      INSTALL ( FILES 
206
65
        ${CMAKE_CURRENT_BINARY_DIR}/zorba_api.php
69
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/XQueryProcessor.php
207
70
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/zorba_api_wrapper.php
208
66
        ${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}/zorba_api.dll
71
        ${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}/zorba_api.dll
209
67
        COMPONENT "php_swig"
72
        COMPONENT "php_swig"
210
68
        DESTINATION share/php )
73
        DESTINATION share/php )
211
69
    ELSE (MSVC_IDE)
74
    ELSE (MSVC_IDE)
212
70
      INSTALL ( FILES 
75
      INSTALL ( FILES 
214
71
        ${CMAKE_CURRENT_BINARY_DIR}/zorba_api.php
76
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/XQueryProcessor.php
215
77
        ${CMAKE_CURRENT_BINARY_DIR}/Zorba/zorba_api_wrapper.php
216
72
        ${CMAKE_CURRENT_BINARY_DIR}/php_zorba_api.dll
78
        ${CMAKE_CURRENT_BINARY_DIR}/php_zorba_api.dll
217
73
        COMPONENT "php_swig"
79
        COMPONENT "php_swig"
218
74
        DESTINATION share/php )
80
        DESTINATION share/php )
219
@@ -77,6 +83,7 @@
220
77
83
221
78
  ### Start PHP proxy generation
84
  ### Start PHP proxy generation
222
79
  # Configure the test file
85
  # Configure the test file
223
86
  SET (phpLibPrefix ${ZORBA_SWIG_LIB_PREFIX})
224
80
  SET (phpAPIPath ${CMAKE_CURRENT_BINARY_DIR})
87
  SET (phpAPIPath ${CMAKE_CURRENT_BINARY_DIR})
225
81
  SET (phpLibPrefix ${ZORBA_SWIG_LIB_PREFIX})
88
  SET (phpLibPrefix ${ZORBA_SWIG_LIB_PREFIX})
226
82
  CONFIGURE_FILE (
89
  CONFIGURE_FILE (
227
@@ -84,8 +91,13 @@
228
84
    ${CMAKE_CURRENT_BINARY_DIR}/generate_proxy.php
91
    ${CMAKE_CURRENT_BINARY_DIR}/generate_proxy.php
229
85
  )
92
  )
230
86
93
231
94
  CONFIGURE_FILE (
232
95
    ${CMAKE_CURRENT_SOURCE_DIR}/XQueryProcessor.php
233
96
    ${CMAKE_CURRENT_BINARY_DIR}/Zorba/XQueryProcessor.php
234
97
  )
235
98
236
87
  ADD_CUSTOM_COMMAND (
99
  ADD_CUSTOM_COMMAND (
238
88
    OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/zorba_api_wrapper.php
100
    OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Zorba/zorba_api_wrapper.php
239
89
    # the following addes a dependency to the *.cxx file that is generated by swig
101
    # the following addes a dependency to the *.cxx file that is generated by swig
240
90
    DEPENDS ${swig_generated_file_fullname}
102
    DEPENDS ${swig_generated_file_fullname}
241
91
    DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/generate_proxy.php.in
103
    DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/generate_proxy.php.in
242
@@ -94,7 +106,8 @@
243
94
  )
106
  )
244
95
  ADD_CUSTOM_TARGET (
107
  ADD_CUSTOM_TARGET (
245
96
    Api_PHP_Wrapper ALL
108
    Api_PHP_Wrapper ALL
247
97
    DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/zorba_api_wrapper.php
109
    DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/Zorba/zorba_api_wrapper.php
248
110
    DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/Zorba/XQueryProcessor.php
249
98
  )
111
  )
250
99
  ### End PHP proxy generation
112
  ### End PHP proxy generation
251
100
113
252
101
114
253
=== added file 'swig/php/XQueryProcessor.php'
254
--- swig/php/XQueryProcessor.php	1970-01-01 00:00:00 +0000
255
+++ swig/php/XQueryProcessor.php	2012-01-07 17:53:24 +0000
256
@@ -0,0 +1,353 @@
257
1
<?php
258
2
require_once 'Zorba/zorba_api_wrapper.php';
259
3
260
4
class XQueryCompilerException extends Exception{}
261
5
class XQueryProcessorException extends Exception{}
262
6
263
7
/**
264
8
 * Iterate over an instance of the XML Data Model (i.e, a sequence of items).
265
9
 * This class implements the SPL Iterator interface.
266
10
 *
267
11
 * The following code snippet iterates over a small sequence of items.
268
12
 * <code>
269
13
 * <?php
270
14
 * require_once 'Zorba/XQueryProcessor.php';
271
15
 *
272
16
 * $xquery = new XQueryProcessor();
273
17
 * $xquery->importQuery('(1, 2, 3)');
274
18
 * 
275
19
 * $iterator = $xquery->getIterator();
276
20
 * foreach($it as $key => $value) {
277
21
 *   echo $value."\n";
278
22
 * }
279
23
 * ?>
280
24
 * </code>
281
25
 */
282
26
class XQueryIterator implements Iterator {
283
27
284
28
  private $xquery   = null;
285
29
  private $iterator = null;
286
30
  private $item     = null;
287
31
  private $position = 0;
288
32
  private $valid    = false;
289
33
290
34
  public function __construct(XQuery $xquery)
291
35
  {
292
36
	  $this->xquery = $xquery;
293
37
    $this->item = Item::createEmptyItem();
294
38
  }
295
39
296
40
  public function __destruct()
297
41
  {
298
42
    $this->xquery->destroy();
299
43
  }
300
44
301
45
  public function rewind()
302
46
  {
303
47
    if ($this->iterator != null) {
304
48
      $this->iterator->close();
305
49
      $this->iterator->destroy();
306
50
    }
307
51
    
308
52
    $this->position = 0;
309
53
    $this->iterator = $this->xquery->iterator(); 
310
54
    $this->iterator->open();
311
55
    $this->valid    = $this->iterator->next($this->item);
312
56
  }
313
57
314
58
  public function current()
315
59
  {
316
60
    return $this->item->serialize();
317
61
  }
318
62
319
63
  public function key()
320
64
  {
321
65
    return $this->position;
322
66
  }
323
67
324
68
  public function next()
325
69
  {
326
70
    ++$this->position;
327
71
    $this->valid = $this->iterator->next($this->item);
328
72
  }
329
73
330
74
  public function valid()
331
75
  {
332
76
    return $this->valid;
333
77
  }
334
78
}
335
79
336
80
/**
337
81
 * The XQueryProcessor class allows to invoke
338
82
 * <a href="http://www.zorba-xquery.com">Zorba XQuery Processor</a>.  
339
83
 *
340
84
 * Instruction to install the extension can be found at <a href=""></a>.
341
85
 *
342
86
 * The following code snippet executes a small <em>Hello World</em> program:
343
87
 * <code>
344
88
 * <?php
345
89
 * require_once 'ZorbaXQueryProcessor.php';
346
90
 *
347
91
 * $xquery = new XQueryProcessor();
348
92
 *
349
93
 * $query = <<<'XQ'
350
94
 * declare variable $name external;
351
95
 *
352
96
 * <h1>Hello {$name}</h1>
353
97
 * XQ;
354
98
 *
355
99
 * $xquery->importQuery($query);
356
100
 *
357
101
 * $xquery->setVariable('name', 'World');
358
102
 *
359
103
 * echo $xquery->execute();
360
104
 * ?>
361
105
 * </code>
362
106
 */
363
107
class XQueryProcessor {
364
108
365
109
  private $store = null;
366
110
  private $zorba = null;
367
111
  private $query = null;
368
112
  private $variables = array();
369
113
370
114
  /**
371
115
   * Creates an XQueryProcessor instance.
372
116
   */
373
117
  public function __construct(){
374
118
    $this->store = InMemoryStore::getInstance();
375
119
    $this->zorba = Zorba::getInstance($this->store);
376
120
  }
377
121
378
122
  /**
379
123
   * Shutdowns the XQueryProcessor instance.
380
124
   */
381
125
  public function __destruct() {
382
126
    $this->zorba->shutdown();
383
127
    InMemoryStore::shutdown($this->store);
384
128
  }
385
129
386
130
  /**
387
131
   * Import a query to execute.
388
132
   * For instance, the following code snippets imports and executes the query '1+1':
389
133
   * <code>
390
134
   * $xquery = new ZorbaXQueryProcessor();
391
135
   *
392
136
   * $xquery->importQuery('1+1');
393
137
   * 
394
138
   * echo $xquery->execute() . '\n';
395
139
   * </code>
396
140
   * In the following code snippet, the following code snippets imports and execute an <em>Hello World</em> query:
397
141
   * <code>
398
142
   * <?php
399
143
   * $xquery = new XQueryProcessor();
400
144
   *
401
145
   * $query = <<<'XQ'
402
146
   * let $world := 'World'
403
147
   * return <h1>Hello {$world}</h1>
404
148
   * XQ;
405
149
   *
406
150
   * $xquery->importQuery($query);
407
151
   *
408
152
   * echo $xquery->execute() . '\n';
409
153
   * ?>
410
154
   * </code>
411
155
   *  
412
156
   * @param $query Query to execute.
413
157
   * @return ZorbaXQueryProcessor instance.
414
158
   */ 
415
159
  public function importQuery($query) {
416
160
	if(!is_string($query)) {
417
161
		throw new XQueryProcessorException('The query parameter must be a string. For instance: XQueryProcessor->importQuery("1+1")');
418
162
	}
419
163
    $this->query = $query;
420
164
    return $this;
421
165
  }
422
166
423
167
  /**
424
168
   * Import a query to execute from its filename.
425
169
   * For instance, the following code snippet imports the query file named <em>hello_word.xq</em>:
426
170
   * <code>
427
171
   * $xquery = new ZorbaXQueryProcessor();
428
172
   *
429
173
   * $xquery->importQueryiFromURI('hello_world.xq');
430
174
   * 
431
175
   * echo $xquery->execute() . '\n';
432
176
   * </code>
433
177
   *
434
178
   * @param  $filename Filename of the query to execute.
435
179
   * @return ZorbaXQueryProcessor instance.
436
180
   */
437
181
  public function importQueryFromURI($filename) {
438
182
    $ctx = null;
439
183
    if(func_num_args() == 2) {
440
184
      $ctx = func_get_arg(1);
441
185
    }
442
186
    $query = file_get_contents($filename, FILE_USE_INCLUDE_PATH, $ctx);
443
187
    $this->importQuery($query);
444
188
    return $this;
445
189
  }
446
190
447
191
  /**
448
192
   * Set value for an external variable.
449
193
   *
450
194
   * The following code snippet sets the value of the variable
451
195
   * <em>$i</em> with <em>1</em>.
452
196
   * <code>
453
197
   * $xquery = new ZorbaXQueryProcessor();
454
198
   * 
455
199
   * $query = <<<'XQ'
456
200
   * declare variable $i as xs:integer external;
457
201
   *
458
202
   * $i + 1
459
203
   * 'XQ';
460
204
   *
461
205
   * $xquery->importQuery($query);
462
206
   * $xquery->setVariable($i, 1);
463
207
   *
464
208
   * echo $xquery->execute() . '\n';
465
209
   * </code>
466
210
   *
467
211
   * The following code snippet sets the value of the variable <em>$i</em> in
468
212
   * the local namespace with the value <em>1</em>.
469
213
   * <code>
470
214
   * $xquery = new ZorbaXQueryProcessor();
471
215
   * 
472
216
   * $query = <<<'XQ'
473
217
   * declare variable $local:i as xs:integer external;
474
218
   *
475
219
   * $i + 1
476
220
   * 'XQ';
477
221
   *
478
222
   * $xquery->importQuery($query);
479
223
   * $xquery->setVariable("http://www.w3.org/2005/xquery-local-functions", $i, 1);
480
224
   *
481
225
   * echo $xquery->execute() . '\n';
482
226
   * </code>
483
227
   *
484
228
   * PHP types are converted to the following XML types:
485
229
   * - <b>string</b>: xs:string
486
230
   * - <b>float</b>: xs:float
487
231
   * - <b>long</b>: xs:long
488
232
   * - <b>integer</b>: xs:integer
489
233
   * - <b>boolean</b>: xs:boolean
490
234
   * - <b>DOMDocument</b>: document-node()    
491
235
   * 
492
236
   * @param string $namespace optional Namespace URI of the external variable.
493
237
   * @param string $name Local name of the external variable.
494
238
   * @param mixed  $value of the external variable.
495
239
   *
496
240
   * return ZorbaXQueryProcessor instance. 
497
241
   */
498
242
  public function setVariable($arg1, $arg2) {
499
243
    $count = func_num_args();
500
244
    if($count == 2) {
501
245
      $name  = func_get_arg(0);
502
246
      $value = func_get_arg(1);
503
247
      $this->variables['_'][$name] = $value;
504
248
    } else {
505
249
      $ns  = func_get_arg(0);
506
250
      $name  = func_get_arg(1);
507
251
      $value = func_get_arg(2);
508
252
      $this->variables[$ns][$name] = $value;
509
253
    }
510
254
    return $this;
511
255
  } 
512
256
  
513
257
  /**
514
258
   * Execute the Query.
515
259
   *
516
260
   * @return Query result.
517
261
   */
518
262
  public function execute() {
519
263
    //Execute
520
264
    $query = $this->compile();
521
265
    $result = $query->execute();
522
266
    $query->destroy();
523
267
    return $result;
524
268
  }
525
269
526
270
  public function getIterator() {
527
271
    return new XQueryIterator($this->compile());
528
272
  }  
529
273
	/**
530
274
	 * 
531
275
	 */
532
276
	private function compile()
533
277
	{
534
278
	  if(!is_string($this->query)) {
535
279
		throw new XQueryCompilerException('No Query Imported. Use XQueryProcessor->importQuery($query).');
536
280
	  }
537
281
	  //Compile Query
538
282
	  $query = $this->zorba->compileQuery($this->query);
539
283
	  //Set Variables
540
284
	  $dctx = $query->getDynamicContext();
541
285
	  foreach($this->variables as $ns => $variables){
542
286
        foreach($variables as $name => $value) {
543
287
          if($ns == "_") $ns = "";
544
288
          $param = $this->zorba->compileQuery(".");
545
289
          $value = $this->getItem($value);
546
290
          $param->getDynamicContext()->setContextItem($value);
547
291
          $dctx->setVariable($ns, $name, $param->iterator());
548
292
	    }
549
293
      }
550
294
	  return $query;
551
295
	}
552
296
553
297
  /*
554
298
   * Converts a PHP value to an XQuery Item.
555
299
   * - DOMDocument & SimpleXMLElement: document-node()
556
300
   * - String: xs:string
557
301
   * - Integer: xs:integer
558
302
   * - Boolean: xs:boolean
559
303
   * - Float: xs:float
560
304
   * - Long: xs:long
561
305
   */  
562
306
	private function getItem($value) {
563
307
      $itemFactory = $this->zorba->getItemFactory();
564
308
565
309
      if($value instanceof DOMDocument or $value instanceof SimpleXMLElement) { 
566
310
        $value = $this->parseXML($value->saveXML());
567
311
      } else if(is_string($value)) {
568
312
        $value = $itemFactory->createString($value);
569
313
      } else if(is_int($value)) {
570
314
        $value = $itemFactory->createInteger($value);
571
315
      } else if(is_bool($value)) {
572
316
        $value = $itemFactory->createBoolean($value);
573
317
      } else if(is_float($value)) {
574
318
        $value = $itemFactory->createFloat($value);
575
319
      } else if(is_long($value)) {
576
320
        $value = $itemFactory->createLong($value);
577
321
      } else  {
578
322
        throw new XQueryCompilerException("Unsupported variable type: ".gettype($value));
579
323
      }
580
324
581
325
      assert($value instanceof Item);
582
326
583
327
      return $value;
584
328
    }
585
329
586
330
  /**
587
331
   * Parse an XML string to an XQuery Item.
588
332
   * This function is used internally only. 
589
333
   * @param $xml string XML string to parse.
590
334
   *
591
335
   * @return Item instance.
592
336
   */
593
337
  private function parseXML($xml)
594
338
  {
595
339
    $lDataManager = $this->zorba->getXmlDataManager();
596
340
    $lDocMgr = $lDataManager->getDocumentManager();
597
341
    $iter = $lDataManager->parseXML($xml);
598
342
    
599
343
    $iter->open();
600
344
    $doc = Item::createEmptyItem();
601
345
    
602
346
    $iter->next($doc);
603
347
    $iter->close();
604
348
    $iter->destroy();
605
349
    
606
350
    return $doc;  
607
351
  }
608
352
}
609
353
?>
610
0
354
611
=== modified file 'swig/php/generate_proxy.php.in'
612
--- swig/php/generate_proxy.php.in	2011-12-21 14:40:33 +0000
613
+++ swig/php/generate_proxy.php.in	2012-01-07 17:53:24 +0000
614
@@ -164,7 +164,7 @@
615
164
	}
164
	}
616
165
}
165
}
617
166
166
619
167
file_put_contents('zorba_api_wrapper.php', $wrapper);
167
file_put_contents('Zorba/zorba_api_wrapper.php', $wrapper);
620
168
168
621
169
function getRefParameters(ReflectionMethod $method, array $params) {
169
function getRefParameters(ReflectionMethod $method, array $params) {
622
170
	$result = "";
170
	$result = "";
623
171
171
624
=== added file 'swig/php/test.xq'
625
--- swig/php/test.xq	1970-01-01 00:00:00 +0000
626
+++ swig/php/test.xq	2012-01-07 17:53:24 +0000
627
@@ -0,0 +1,1 @@
628
1
1+1
Status:	Superseded
Proposed branch:	lp:~zorba-coders/zorba/phpapi
Merge into:	lp:zorba
Diff against target:	628 lines (+507/-10) 8 files modified doc/php/examples/CMakeLists.txt (+10/-3) doc/php/examples/php.ini.in (+1/-0) doc/php/examples/simple.php.in (+1/-1) doc/php/examples/test.php.in (+122/-0) swig/php/CMakeLists.txt (+18/-5) swig/php/XQueryProcessor.php (+353/-0) swig/php/generate_proxy.php.in (+1/-1) swig/php/test.xq (+1/-0)
To merge this branch:	bzr merge lp:~zorba-coders/zorba/phpapi
Related bugs:	Link a bug report
Reviewer	Date Requested	Status
Rodolfo Ochoa	2012-01-06	Pending
Matthias Brantner	2012-01-06	Pending
David Graf	2012-01-06	Pending
Review via email: mp+87718@code.launchpad.net