starting php support addition

generators/php.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Helper functions for generating PHP for blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP');
+
+goog.require('Blockly.Generator');
+
+
+/**
+ * PHP code generator.
+ * @type !Blockly.Generator
+ */
+Blockly.PHP = new Blockly.Generator('PHP');
+
+/**
+ * List of illegal variable names.
+ * This is not intended to be a security feature.  Blockly is 100% client-side,
+ * so bypassing this list is trivial.  This is intended to prevent users from
+ * accidentally clobbering a built-in object or function.
+ * @private
+ */
+Blockly.PHP.addReservedWords(
+    'Blockly,' +  // In case JS is evaled in the current window.
+        // http://php.net/manual/en/reserved.keywords.php
+    '__halt_compiler,abstract,and,array,as,break,callable,case,catch,class,clone,const,continue,declare,default,die,do,echo,else,elseif,empty,enddeclare,endfor,endforeach,endif,endswitch,endwhile,eval,exit,extends,final,for,foreach,function,global,goto,if,implements,include,include_once,instanceof,insteadof,interface,isset,list,namespace,new,or,print,private,protected,public,require,require_once,return,static,switch,throw,trait,try,unset,use,var,while,xor,' +
+        // http://php.net/manual/en/reserved.constants.php
+    'PHP_VERSION,PHP_MAJOR_VERSION,PHP_MINOR_VERSION,PHP_RELEASE_VERSION,PHP_VERSION_ID,PHP_EXTRA_VERSION,PHP_ZTS,PHP_DEBUG,PHP_MAXPATHLEN,PHP_OS,PHP_SAPI,PHP_EOL,PHP_INT_MAX,PHP_INT_SIZE,DEFAULT_INCLUDE_PATH,PEAR_INSTALL_DIR,PEAR_EXTENSION_DIR,PHP_EXTENSION_DIR,PHP_PREFIX,PHP_BINDIR,PHP_BINARY,PHP_MANDIR,PHP_LIBDIR,PHP_DATADIR,PHP_SYSCONFDIR,PHP_LOCALSTATEDIR,PHP_CONFIG_FILE_PATH,PHP_CONFIG_FILE_SCAN_DIR,PHP_SHLIB_SUFFIX,E_ERROR,E_WARNING,E_PARSE,E_NOTICE,E_CORE_ERROR,E_CORE_WARNING,E_COMPILE_ERROR,E_COMPILE_WARNING,E_USER_ERROR,E_USER_WARNING,E_USER_NOTICE,E_DEPRECATED,E_USER_DEPRECATED,E_ALL,E_STRICT,__COMPILER_HALT_OFFSET__,TRUE,FALSE,NULL,__CLASS__,__DIR__,__FILE__,__FUNCTION__,__LINE__,__METHOD__,__NAMESPACE__,__TRAIT__');
+        // there are more than 9,000 internal functions in http://php.net/manual/en/indexes.functions.php
+        // do we really need to list them here?
+
+/**
+ * Order of operation ENUMs.
+ * https://developer.mozilla.org/en/PHP/Reference/Operators/Operator_Precedence
+ */
+Blockly.PHP.ORDER_ATOMIC = 0;         // 0 "" ...
+Blockly.PHP.ORDER_CLONE = 1;          // clone
+Blockly.PHP.ORDER_NEW = 1;            // new
+Blockly.PHP.ORDER_FUNCTION_CALL = 2;  // ()
+Blockly.PHP.ORDER_INCREMENT = 3;      // ++
+Blockly.PHP.ORDER_DECREMENT = 3;      // --
+Blockly.PHP.ORDER_LOGICAL_NOT = 4;    // !
+Blockly.PHP.ORDER_BITWISE_NOT = 4;    // ~
+Blockly.PHP.ORDER_UNARY_PLUS = 4;     // +
+Blockly.PHP.ORDER_UNARY_NEGATION = 4; // -
+Blockly.PHP.ORDER_TYPEOF = 4;         // typeof
+Blockly.PHP.ORDER_VOID = 4;           // void
+Blockly.PHP.ORDER_DELETE = 4;         // delete
+Blockly.PHP.ORDER_MULTIPLICATION = 5; // *
+Blockly.PHP.ORDER_DIVISION = 5;       // /
+Blockly.PHP.ORDER_MODULUS = 5;        // %
+Blockly.PHP.ORDER_ADDITION = 6;       // +
+Blockly.PHP.ORDER_SUBTRACTION = 6;    // -
+Blockly.PHP.ORDER_BITWISE_SHIFT = 7;  // << >> >>>
+Blockly.PHP.ORDER_RELATIONAL = 8;     // < <= > >=
+Blockly.PHP.ORDER_IN = 8;             // in
+Blockly.PHP.ORDER_INSTANCEOF = 8;     // instanceof
+Blockly.PHP.ORDER_EQUALITY = 9;       // == != === !==
+Blockly.PHP.ORDER_BITWISE_AND = 10;   // &
+Blockly.PHP.ORDER_BITWISE_XOR = 11;   // ^
+Blockly.PHP.ORDER_BITWISE_OR = 12;    // |
+Blockly.PHP.ORDER_CONDITIONAL = 13;   // ?:
+Blockly.PHP.ORDER_ASSIGNMENT = 14;    // = += -= *= /= %= <<= >>= ...
+Blockly.PHP.ORDER_LOGICAL_AND = 15;   // &&
+Blockly.PHP.ORDER_LOGICAL_OR = 16;    // ||
+Blockly.PHP.ORDER_COMMA = 17;         // ,
+Blockly.PHP.ORDER_NONE = 99;          // (...)
+
+/**
+ * Initialise the database of variable names.
+ * @param {!Blockly.Workspace} workspace Workspace to generate code from.
+ */
+Blockly.PHP.init = function(workspace) {
+  // Create a dictionary of definitions to be printed before the code.
+  Blockly.PHP.definitions_ = Object.create(null);
+  // Create a dictionary mapping desired function names in definitions_
+  // to actual function names (to avoid collisions with user functions).
+  Blockly.PHP.functionNames_ = Object.create(null);
+
+  if (!Blockly.PHP.variableDB_) {
+    Blockly.PHP.variableDB_ =
+        new Blockly.Names(Blockly.PHP.RESERVED_WORDS_);
+  } else {
+    Blockly.PHP.variableDB_.reset();
+  }
+
+  var defvars = [];
+  var variables = Blockly.Variables.allVariables(workspace);
+  for (var x = 0; x < variables.length; x++) {
+    defvars[x] = 'var ' +
+        Blockly.PHP.variableDB_.getName(variables[x],
+        Blockly.Variables.NAME_TYPE) + ';';
+  }
+  Blockly.PHP.definitions_['variables'] = defvars.join('\n');
+};
+
+/**
+ * Prepend the generated code with the variable definitions.
+ * @param {string} code Generated code.
+ * @return {string} Completed code.
+ */
+Blockly.PHP.finish = function(code) {
+  // Convert the definitions dictionary into a list.
+  var definitions = [];
+  for (var name in Blockly.PHP.definitions_) {
+    definitions.push(Blockly.PHP.definitions_[name]);
+  }
+  return definitions.join('\n\n') + '\n\n\n' + code;
+};
+
+/**
+ * Naked values are top-level blocks with outputs that aren't plugged into
+ * anything.  A trailing semicolon is needed to make this legal.
+ * @param {string} line Line of generated code.
+ * @return {string} Legal line of code.
+ */
+Blockly.PHP.scrubNakedValue = function(line) {
+  return line + ';\n';
+};
+
+/**
+ * Encode a string as a properly escaped PHP string, complete with
+ * quotes.
+ * @param {string} string Text to encode.
+ * @return {string} PHP string.
+ * @private
+ */
+Blockly.PHP.quote_ = function(string) {
+  // TODO: This is a quick hack.  Replace with goog.string.quote
+  string = string.replace(/\\/g, '\\\\')
+                 .replace(/\n/g, '\\\n')
+                 .replace(/'/g, '\\\'');
+  return '\'' + string + '\'';
+};
+
+/**
+ * Common tasks for generating PHP from blocks.
+ * Handles comments for the specified block and any connected value blocks.
+ * Calls any statements following this block.
+ * @param {!Blockly.Block} block The current block.
+ * @param {string} code The PHP code created for this block.
+ * @return {string} PHP code with comments and subsequent blocks added.
+ * @private
+ */
+Blockly.PHP.scrub_ = function(block, code) {
+  var commentCode = '';
+  // Only collect comments for blocks that aren't inline.
+  if (!block.outputConnection || !block.outputConnection.targetConnection) {
+    // Collect comment for this block.
+    var comment = block.getCommentText();
+    if (comment) {
+      commentCode += Blockly.PHP.prefixLines(comment, '// ') + '\n';
+    }
+    // Collect comments for all value arguments.
+    // Don't collect comments for nested statements.
+    for (var x = 0; x < block.inputList.length; x++) {
+      if (block.inputList[x].type == Blockly.INPUT_VALUE) {
+        var childBlock = block.inputList[x].connection.targetBlock();
+        if (childBlock) {
+          var comment = Blockly.PHP.allNestedComments(childBlock);
+          if (comment) {
+            commentCode += Blockly.PHP.prefixLines(comment, '// ');
+          }
+        }
+      }
+    }
+  }
+  var nextBlock = block.nextConnection && block.nextConnection.targetBlock();
+  var nextCode = Blockly.PHP.blockToCode(nextBlock);
+  return commentCode + code + nextCode;
+};

generators/php/colour.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for colour blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.colour');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['colour_picker'] = function(block) {
+  // Colour picker.
+  var code = '\'' + block.getFieldValue('COLOUR') + '\'';
+  return [code, Blockly.PHP.ORDER_ATOMIC];
+};
+
+Blockly.PHP['colour_random'] = function(block) {
+  // Generate a random colour.
+  var functionName = Blockly.PHP.provideFunction_(
+      'colour_random',
+      [ 'function ' + Blockly.PHP.FUNCTION_NAME_PLACEHOLDER_ + '() {',
+        '  return \'#\' . str_pad(dechex(mt_rand(0, 0xFFFFFF)), 6, \'0\', STR_PAD_LEFT);',
+        '}']);
+  var code = functionName + '()';
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['colour_rgb'] = function(block) {
+  // Compose a colour from RGB components expressed as percentages.
+  var red = Blockly.PHP.valueToCode(block, 'RED',
+      Blockly.PHP.ORDER_COMMA) || 0;
+  var green = Blockly.PHP.valueToCode(block, 'GREEN',
+      Blockly.PHP.ORDER_COMMA) || 0;
+  var blue = Blockly.PHP.valueToCode(block, 'BLUE',
+      Blockly.PHP.ORDER_COMMA) || 0;
+  var functionName = Blockly.PHP.provideFunction_(
+      'colour_rgb',
+      [ 'function ' + Blockly.PHP.FUNCTION_NAME_PLACEHOLDER_ +
+          '($r, $g, $b) {',
+        '  $hex = "#";',
+        '  $hex .= str_pad(dechex($r), 2, "0", STR_PAD_LEFT);',
+        '  $hex .= str_pad(dechex($g), 2, "0", STR_PAD_LEFT);',
+        '  $hex .= str_pad(dechex($b), 2, "0", STR_PAD_LEFT);',
+        '  return $hex;',
+        '}']);
+  var code = functionName + '($' + red + ', $' + green + ', $' + blue + ')';
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['colour_blend'] = function(block) {
+  // Blend two colours together.
+  var c1 = Blockly.PHP.valueToCode(block, 'COLOUR1',
+      Blockly.PHP.ORDER_COMMA) || '\'#000000\'';
+  var c2 = Blockly.PHP.valueToCode(block, 'COLOUR2',
+      Blockly.PHP.ORDER_COMMA) || '\'#000000\'';
+  var ratio = Blockly.PHP.valueToCode(block, 'RATIO',
+      Blockly.PHP.ORDER_COMMA) || 0.5;
+  var functionName = Blockly.PHP.provideFunction_(
+      'colour_blend',
+      [ 'function ' + Blockly.PHP.FUNCTION_NAME_PLACEHOLDER_ +
+          '($c1, $c2, $ratio) {',
+        '  $ratio = max(min($ratio, 1), 0);',
+        '  $r1 = hexdec(substr($c1,0,2));',
+        '  $g1 = hexdec(substr($c1,2,2));',
+        '  $b1 = hexdec(substr($c1,4,2));',
+        '  $r2 = hexdec(substr($c2,0,2));',
+        '  $g2 = hexdec(substr($c2,2,2));',
+        '  $b2 = hexdec(substr($c2,4,2));',
+        '  $r = round($r1 * (1 - $ratio) + $r2 * $ratio);',
+        '  $g = round($g1 * (1 - $ratio) + $g2 * $ratio);',
+        '  $b = round($b1 * (1 - $ratio) + $b2 * $ratio);',
+        '  $hex = "#";',
+        '  $hex .= str_pad(dechex($r), 2, "0", STR_PAD_LEFT);',
+        '  $hex .= str_pad(dechex($g), 2, "0", STR_PAD_LEFT);',
+        '  $hex .= str_pad(dechex($b), 2, "0", STR_PAD_LEFT);',
+        '  return $hex;',
+        '}']);
+  var code = functionName + '($' + c1 + ', $' + c2 + ', $' + ratio + ')';
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};

generators/php/logic.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for logic blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.logic');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['controls_if'] = function(block) {
+  // If/elseif/else condition.
+  var n = 0;
+  var argument = Blockly.PHP.valueToCode(block, 'IF' + n,
+      Blockly.PHP.ORDER_NONE) || 'false';
+  var branch = Blockly.PHP.statementToCode(block, 'DO' + n);
+  var code = 'if (' + argument + ') {\n' + branch + '}';
+  for (n = 1; n <= block.elseifCount_; n++) {
+    argument = Blockly.PHP.valueToCode(block, 'IF' + n,
+        Blockly.PHP.ORDER_NONE) || 'false';
+    branch = Blockly.PHP.statementToCode(block, 'DO' + n);
+    code += ' else if (' + argument + ') {\n' + branch + '}';
+  }
+  if (block.elseCount_) {
+    branch = Blockly.PHP.statementToCode(block, 'ELSE');
+    code += ' else {\n' + branch + '}';
+  }
+  return code + '\n';
+};
+
+Blockly.PHP['logic_compare'] = function(block) {
+  // Comparison operator.
+  var OPERATORS = {
+    'EQ': '==',
+    'NEQ': '!=',
+    'LT': '<',
+    'LTE': '<=',
+    'GT': '>',
+    'GTE': '>='
+  };
+  var operator = OPERATORS[block.getFieldValue('OP')];
+  var order = (operator == '==' || operator == '!=') ?
+      Blockly.PHP.ORDER_EQUALITY : Blockly.PHP.ORDER_RELATIONAL;
+  var argument0 = Blockly.PHP.valueToCode(block, 'A', order) || '0';
+  var argument1 = Blockly.PHP.valueToCode(block, 'B', order) || '0';
+  var code = argument0 + ' ' + operator + ' ' + argument1;
+  return [code, order];
+};
+
+Blockly.PHP['logic_operation'] = function(block) {
+  // Operations 'and', 'or'.
+  var operator = (block.getFieldValue('OP') == 'AND') ? '&&' : '||';
+  var order = (operator == '&&') ? Blockly.PHP.ORDER_LOGICAL_AND :
+      Blockly.PHP.ORDER_LOGICAL_OR;
+  var argument0 = Blockly.PHP.valueToCode(block, 'A', order);
+  var argument1 = Blockly.PHP.valueToCode(block, 'B', order);
+  if (!argument0 && !argument1) {
+    // If there are no arguments, then the return value is false.
+    argument0 = 'false';
+    argument1 = 'false';
+  } else {
+    // Single missing arguments have no effect on the return value.
+    var defaultArgument = (operator == '&&') ? 'true' : 'false';
+    if (!argument0) {
+      argument0 = defaultArgument;
+    }
+    if (!argument1) {
+      argument1 = defaultArgument;
+    }
+  }
+  var code = argument0 + ' ' + operator + ' ' + argument1;
+  return [code, order];
+};
+
+Blockly.PHP['logic_negate'] = function(block) {
+  // Negation.
+  var order = Blockly.PHP.ORDER_LOGICAL_NOT;
+  var argument0 = Blockly.PHP.valueToCode(block, 'BOOL', order) ||
+      'true';
+  var code = '!' + argument0;
+  return [code, order];
+};
+
+Blockly.PHP['logic_boolean'] = function(block) {
+  // Boolean values true and false.
+  var code = (block.getFieldValue('BOOL') == 'TRUE') ? 'true' : 'false';
+  return [code, Blockly.PHP.ORDER_ATOMIC];
+};
+
+Blockly.PHP['logic_null'] = function(block) {
+  // Null data type.
+  return ['null', Blockly.PHP.ORDER_ATOMIC];
+};
+
+Blockly.PHP['logic_ternary'] = function(block) {
+  // Ternary operator.
+  var value_if = Blockly.PHP.valueToCode(block, 'IF',
+      Blockly.PHP.ORDER_CONDITIONAL) || 'false';
+  var value_then = Blockly.PHP.valueToCode(block, 'THEN',
+      Blockly.PHP.ORDER_CONDITIONAL) || 'null';
+  var value_else = Blockly.PHP.valueToCode(block, 'ELSE',
+      Blockly.PHP.ORDER_CONDITIONAL) || 'null';
+  var code = value_if + ' ? ' + value_then + ' : ' + value_else;
+  return [code, Blockly.PHP.ORDER_CONDITIONAL];
+};

generators/php/loops.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for loop blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.loops');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['controls_repeat'] = function(block) {
+  // Repeat n times (internal number).
+  var repeats = Number(block.getFieldValue('TIMES'));
+  var branch = Blockly.PHP.statementToCode(block, 'DO');
+  branch = Blockly.PHP.addLoopTrap(branch, block.id);
+  var loopVar = Blockly.PHP.variableDB_.getDistinctName(
+      'count', Blockly.Variables.NAME_TYPE);
+  var code = 'for ($' + loopVar + ' = 0; $' +
+      loopVar + ' < ' + repeats + '; $' +
+      loopVar + '++) {\n' +
+      branch + '}\n';
+  return code;
+};
+
+Blockly.PHP['controls_repeat_ext'] = function(block) {
+  // Repeat n times (external number).
+  var repeats = Blockly.PHP.valueToCode(block, 'TIMES',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '0';
+  var branch = Blockly.PHP.statementToCode(block, 'DO');
+  branch = Blockly.PHP.addLoopTrap(branch, block.id);
+  var code = '';
+  var loopVar = Blockly.PHP.variableDB_.getDistinctName(
+      'count', Blockly.Variables.NAME_TYPE);
+  var endVar = repeats;
+  if (!repeats.match(/^\w+$/) && !Blockly.isNumber(repeats)) {
+    var endVar = Blockly.PHP.variableDB_.getDistinctName(
+        'repeat_end', Blockly.Variables.NAME_TYPE);
+    code += 'var ' + endVar + ' = ' + repeats + ';\n';
+  }
+  code += 'for ($' + loopVar + ' = 0; $' +
+      loopVar + ' < $' + endVar + '; $' +
+      loopVar + '++) {\n' +
+      branch + '}\n';
+  return code;
+};
+
+Blockly.PHP['controls_whileUntil'] = function(block) {
+  // Do while/until loop.
+  var until = block.getFieldValue('MODE') == 'UNTIL';
+  var argument0 = Blockly.PHP.valueToCode(block, 'BOOL',
+      until ? Blockly.PHP.ORDER_LOGICAL_NOT :
+      Blockly.PHP.ORDER_NONE) || 'false';
+  var branch = Blockly.PHP.statementToCode(block, 'DO');
+  branch = Blockly.PHP.addLoopTrap(branch, block.id);
+  if (until) {
+    argument0 = '!' + argument0;
+  }
+  return 'while (' + argument0 + ') {\n' + branch + '}\n';
+};
+
+Blockly.PHP['controls_for'] = function(block) {
+  // For loop.
+  var variable0 = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('VAR'), Blockly.Variables.NAME_TYPE);
+  var argument0 = Blockly.PHP.valueToCode(block, 'FROM',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '0';
+  var argument1 = Blockly.PHP.valueToCode(block, 'TO',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '0';
+  var increment = Blockly.PHP.valueToCode(block, 'BY',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '1';
+  var branch = Blockly.PHP.statementToCode(block, 'DO');
+  branch = Blockly.PHP.addLoopTrap(branch, block.id);
+  var code;
+  if (Blockly.isNumber(argument0) && Blockly.isNumber(argument1) &&
+      Blockly.isNumber(increment)) {
+    // All arguments are simple numbers.
+    var up = parseFloat(argument0) <= parseFloat(argument1);
+    code = 'for ($' + variable0 + ' = ' + argument0 + '; $' +
+        variable0 + (up ? ' <= ' : ' >= ') + argument1 + '; $' +
+        variable0;
+    var step = Math.abs(parseFloat(increment));
+    if (step == 1) {
+      code += up ? '++' : '--';
+    } else {
+      code += (up ? ' += ' : ' -= ') + step;
+    }
+    code += ') {\n' + branch + '}\n';
+  } else {
+    code = '';
+    // Cache non-trivial values to variables to prevent repeated look-ups.
+    var startVar = argument0;
+    if (!argument0.match(/^\w+$/) && !Blockly.isNumber(argument0)) {
+      startVar = Blockly.PHP.variableDB_.getDistinctName(
+          variable0 + '_start', Blockly.Variables.NAME_TYPE);
+      code += '$' + startVar + ' = ' + argument0 + ';\n';
+    }
+    var endVar = argument1;
+    if (!argument1.match(/^\w+$/) && !Blockly.isNumber(argument1)) {
+      var endVar = Blockly.PHP.variableDB_.getDistinctName(
+          variable0 + '_end', Blockly.Variables.NAME_TYPE);
+      code += '$' + endVar + ' = ' + argument1 + ';\n';
+    }
+    // Determine loop direction at start, in case one of the bounds
+    // changes during loop execution.
+    var incVar = Blockly.PHP.variableDB_.getDistinctName(
+        variable0 + '_inc', Blockly.Variables.NAME_TYPE);
+    code += '$' + incVar + ' = ';
+    if (Blockly.isNumber(increment)) {
+      code += Math.abs(increment) + ';\n';
+    } else {
+      code += 'abs(' + increment + ');\n';
+    }
+    code += 'if ($' + startVar + ' > $' + endVar + ') {\n';
+    code += Blockly.PHP.INDENT + '$' + incVar + ' = -$' + incVar + ';\n';
+    code += '}\n';
+    code += 'for (' + variable0 + ' = $' + startVar + ';\n' +
+        '     ' + incVar + ' >= 0 ? $' +
+        variable0 + ' <= ' + endVar + ' : $' +
+        variable0 + ' >= ' + endVar + ';\n' +
+        '     ' + variable0 + ' += $' + incVar + ') {\n' +
+        branch + '}\n';
+  }
+  return code;
+};
+
+Blockly.PHP['controls_forEach'] = function(block) {
+  // For each loop.
+  var variable0 = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('VAR'), Blockly.Variables.NAME_TYPE);
+  var argument0 = Blockly.PHP.valueToCode(block, 'LIST',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '[]';
+  var branch = Blockly.PHP.statementToCode(block, 'DO');
+  branch = Blockly.PHP.addLoopTrap(branch, block.id);
+  var code = '';
+  // Cache non-trivial values to variables to prevent repeated look-ups.
+  var listVar = argument0;
+  if (!argument0.match(/^\w+$/)) {
+    listVar = Blockly.PHP.variableDB_.getDistinctName(
+        variable0 + '_list', Blockly.Variables.NAME_TYPE);
+    code += '$' + listVar + ' = ' + argument0 + ';\n';
+  }
+  var indexVar = Blockly.PHP.variableDB_.getDistinctName(
+      variable0 + '_index', Blockly.Variables.NAME_TYPE);
+  branch = Blockly.PHP.INDENT + variable0 + ' = ' +
+      listVar + '[' + indexVar + '];\n' + branch;
+  code += 'foreach ($' + listVar + ' as $' + indexVar + ') {\n' + branch + '}\n';
+  return code;
+};
+
+Blockly.PHP['controls_flow_statements'] = function(block) {
+  // Flow statements: continue, break.
+  switch (block.getFieldValue('FLOW')) {
+    case 'BREAK':
+      return 'break;\n';
+    case 'CONTINUE':
+      return 'continue;\n';
+  }
+  throw 'Unknown flow statement.';
+};

generators/php/procedures.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for procedure blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.procedures');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['procedures_defreturn'] = function(block) {
+  // Define a procedure with a return value.
+  var funcName = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('NAME'), Blockly.Procedures.NAME_TYPE);
+  var branch = Blockly.PHP.statementToCode(block, 'STACK');
+  if (Blockly.PHP.STATEMENT_PREFIX) {
+    branch = Blockly.PHP.prefixLines(
+        Blockly.PHP.STATEMENT_PREFIX.replace(/%1/g,
+        '\'' + block.id + '\''), Blockly.PHP.INDENT) + branch;
+  }
+  if (Blockly.PHP.INFINITE_LOOP_TRAP) {
+    branch = Blockly.PHP.INFINITE_LOOP_TRAP.replace(/%1/g,
+        '\'' + block.id + '\'') + branch;
+  }
+  var returnValue = Blockly.PHP.valueToCode(block, 'RETURN',
+      Blockly.PHP.ORDER_NONE) || '';
+  if (returnValue) {
+    returnValue = '  return ' + returnValue + ';\n';
+  }
+  var args = [];
+  for (var x = 0; x < block.arguments_.length; x++) {
+    args[x] = Blockly.PHP.variableDB_.getName(block.arguments_[x],
+        Blockly.Variables.NAME_TYPE);
+  }
+  var code = 'function ' + funcName + '(' + args.join(', ') + ') {\n' +
+      branch + returnValue + '}';
+  code = Blockly.PHP.scrub_(block, code);
+  Blockly.PHP.definitions_[funcName] = code;
+  return null;
+};
+
+// Defining a procedure without a return value uses the same generator as
+// a procedure with a return value.
+Blockly.PHP['procedures_defnoreturn'] =
+    Blockly.PHP['procedures_defreturn'];
+
+Blockly.PHP['procedures_callreturn'] = function(block) {
+  // Call a procedure with a return value.
+  var funcName = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('NAME'), Blockly.Procedures.NAME_TYPE);
+  var args = [];
+  for (var x = 0; x < block.arguments_.length; x++) {
+    args[x] = Blockly.PHP.valueToCode(block, 'ARG' + x,
+        Blockly.PHP.ORDER_COMMA) || 'null';
+  }
+  var code = funcName + '(' + args.join(', ') + ')';
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['procedures_callnoreturn'] = function(block) {
+  // Call a procedure with no return value.
+  var funcName = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('NAME'), Blockly.Procedures.NAME_TYPE);
+  var args = [];
+  for (var x = 0; x < block.arguments_.length; x++) {
+    args[x] = Blockly.PHP.valueToCode(block, 'ARG' + x,
+        Blockly.PHP.ORDER_COMMA) || 'null';
+  }
+  var code = funcName + '(' + args.join(', ') + ');\n';
+  return code;
+};
+
+Blockly.PHP['procedures_ifreturn'] = function(block) {
+  // Conditionally return value from a procedure.
+  var condition = Blockly.PHP.valueToCode(block, 'CONDITION',
+      Blockly.PHP.ORDER_NONE) || 'false';
+  var code = 'if (' + condition + ') {\n';
+  if (block.hasReturnValue_) {
+    var value = Blockly.PHP.valueToCode(block, 'VALUE',
+        Blockly.PHP.ORDER_NONE) || 'null';
+    code += '  return ' + value + ';\n';
+  } else {
+    code += '  return;\n';
+  }
+  code += '}\n';
+  return code;
+};

generators/php/text.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for text blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.texts');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['text'] = function(block) {
+  // Text value.
+  var code = Blockly.PHP.quote_(block.getFieldValue('TEXT'));
+  return [code, Blockly.PHP.ORDER_ATOMIC];
+};
+
+Blockly.PHP['text_join'] = function(block) {
+  // Create a string made up of any number of elements of any type.
+  var code;
+  if (block.itemCount_ == 0) {
+    return ['\'\'', Blockly.PHP.ORDER_ATOMIC];
+  } else if (block.itemCount_ == 1) {
+    var argument0 = Blockly.PHP.valueToCode(block, 'ADD0',
+        Blockly.PHP.ORDER_NONE) || '\'\'';
+    code = argument0;
+    return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+  } else if (block.itemCount_ == 2) {
+    var argument0 = Blockly.PHP.valueToCode(block, 'ADD0',
+        Blockly.PHP.ORDER_NONE) || '\'\'';
+    var argument1 = Blockly.PHP.valueToCode(block, 'ADD1',
+        Blockly.PHP.ORDER_NONE) || '\'\'';
+    code = argument0 + ' . ' + argument1;
+    return [code, Blockly.PHP.ORDER_ADDITION];
+  } else {
+    code = new Array(block.itemCount_);
+    for (var n = 0; n < block.itemCount_; n++) {
+      code[n] = Blockly.PHP.valueToCode(block, 'ADD' + n,
+          Blockly.PHP.ORDER_COMMA) || '\'\'';
+    }
+    code = 'implode(\',\'' + code.join(',') + ')';
+    return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+  }
+};
+
+Blockly.PHP['text_append'] = function(block) {
+  // Append to a variable in place.
+  var varName = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('VAR'), Blockly.Variables.NAME_TYPE);
+  var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+      Blockly.PHP.ORDER_NONE) || '\'\'';
+  return varName + ' = ' + varName + ' . ' + argument0 + ';\n';
+};
+
+Blockly.PHP['text_length'] = function(block) {
+  // String length.
+  var argument0 = Blockly.PHP.valueToCode(block, 'VALUE',
+      Blockly.PHP.ORDER_FUNCTION_CALL) || '\'\'';
+  return ['strlen(' + argument0 + ')', Blockly.PHP.ORDER_MEMBER];
+};
+
+Blockly.PHP['text_isEmpty'] = function(block) {
+  // Is the string null?
+  var argument0 = Blockly.PHP.valueToCode(block, 'VALUE',
+      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+  return ['empty(' + argument0 + ')', Blockly.PHP.ORDER_LOGICAL_NOT];
+};
+
+Blockly.PHP['text_indexOf'] = function(block) {
+  // Search the text for a substring.
+  var operator = block.getFieldValue('END') == 'FIRST' ?
+      'strpos' : 'strrpos';
+  var argument0 = Blockly.PHP.valueToCode(block, 'FIND',
+      Blockly.PHP.ORDER_NONE) || '\'\'';
+  var argument1 = Blockly.PHP.valueToCode(block, 'VALUE',
+      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+  var code = operator + '(' + argument0 + ', ' + argument1 + ') + 1';
+  return [code, Blockly.PHP.ORDER_MEMBER];
+};
+
+Blockly.PHP['text_charAt'] = function(block) {
+  // Get letter at index.
+  var where = block.getFieldValue('WHERE') || 'FROM_START';
+  var at = Blockly.PHP.valueToCode(block, 'AT',
+      Blockly.PHP.ORDER_UNARY_NEGATION) || '1';
+  var text = Blockly.PHP.valueToCode(block, 'VALUE',
+      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+  switch (where) {
+    case 'FIRST':
+      var code = text + '[0]';
+      return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+    case 'LAST':
+      var code = 'substr(' + text + ',-1,1)';
+      return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+    case 'FROM_START':
+      // Blockly uses one-based indicies.
+      if (Blockly.isNumber(at)) {
+        // If the index is a naked number, decrement it right now.
+        at = parseFloat(at) - 1;
+      } else {
+        // If the index is dynamic, decrement it in code.
+        at += ' - 1';
+      }
+      var code = 'substr(' + text + ', ' + at + ', 1)';
+      return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+    case 'FROM_END':
+      var code = 'substr(' + text + ', -' + at + ', 1)';
+      return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+    case 'RANDOM':
+      var functionName = Blockly.PHP.provideFunction_(
+          'text_random_letter',
+          [ 'function ' + Blockly.PHP.FUNCTION_NAME_PLACEHOLDER_ +
+              '($text) {',
+            '  return $text[rand(0, strlen($text)-1)];',
+            '}']);
+      code = functionName + '(' + text + ')';
+      return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+  }
+  throw 'Unhandled option (text_charAt).';
+};
+
+Blockly.PHP['text_getSubstring'] = function(block) {
+  // Get substring.
+  var text = Blockly.PHP.valueToCode(block, 'STRING',
+      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+  var where1 = block.getFieldValue('WHERE1');
+  var where2 = block.getFieldValue('WHERE2');
+  var at1 = Blockly.PHP.valueToCode(block, 'AT1',
+      Blockly.PHP.ORDER_NONE) || '1';
+  var at2 = Blockly.PHP.valueToCode(block, 'AT2',
+      Blockly.PHP.ORDER_NONE) || '1';
+  if (where1 == 'FIRST' && where2 == 'LAST') {
+    var code = text;
+  } else {
+    var functionName = Blockly.PHP.provideFunction_(
+        'text_get_substring',
+        [ 'function ' + Blockly.PHP.FUNCTION_NAME_PLACEHOLDER_ +
+            '($text, $where1, $at1, $where2, $at2) {',
+          '    if ($where1 == \'FROM_START\') {',
+          '      $at1--;',
+          '    } else if ($where1 == \'FROM_END\') {',
+          '      $at1 = strlen($text) - $at;',
+          '    } else if ($where1 == \'FIRST\') {',
+          '      $at1 = 0;',
+          '    } else if (where1 == \'LAST\') {',
+          '      $at1 = strlen($text) - 1;',
+          '    } else { $at1 = 0; }',
+          '    if ($where2 == \'FROM_START\') {',
+          '      $at2--;',
+          '    } else if ($where2 == \'FROM_END\') {',
+          '      $at2 = strlen($text) - $at;',
+          '    } else if ($where2 == \'FIRST\') {',
+          '      $at2 = 0;',
+          '    } else if (where2 == \'LAST\') {',
+          '      $at2 = strlen($text) - 1;',
+          '    } else { $at2 = 0; }',
+          '  $at1 = getAt($where1, $at1);',
+          '  $at2 = getAt($where2, $at2) + 1;',
+          '  return substr($text, $at1, $at2);',
+          '}']);
+    var code = functionName + '(' + text + ', \'' +
+        where1 + '\', ' + at1 + ', \'' + where2 + '\', ' + at2 + ')';
+  }
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['text_changeCase'] = function(block) {
+  // Change capitalization.
+  var code;
+  if (block.getFieldValue('CASE')=='UPPERCASE') {
+    var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+            Blockly.PHP.ORDER_MEMBER) || '\'\'';
+    code = 'strtoupper(' + argument0 + ')';
+  } else if (block.getFieldValue('CASE')=='LOWERCASE') {
+    var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+            Blockly.PHP.ORDER_MEMBER) || '\'\'';
+    code = 'strtolower(' + argument0 + ')';
+  } else if (block.getFieldValue('CASE')=='TITLECASE') {
+    var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+            Blockly.PHP.ORDER_MEMBER) || '\'\'';
+    code = 'ucwords(' + argument0 + ')';
+  }
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['text_trim'] = function(block) {
+  // Trim spaces.
+  var OPERATORS = {
+    'LEFT': 'ltrim',
+    'RIGHT': 'rtrim',
+    'BOTH': 'trim'
+  };
+  var operator = OPERATORS[block.getFieldValue('MODE')];
+  var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+      Blockly.PHP.ORDER_MEMBER) || '\'\'';
+  return [ operator + '(' + argument0 + ')', Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['text_print'] = function(block) {
+  // Print statement.
+  var argument0 = Blockly.PHP.valueToCode(block, 'TEXT',
+      Blockly.PHP.ORDER_NONE) || '\'\'';
+  return 'print(' + argument0 + ');\n';
+};
+
+Blockly.PHP['text_prompt'] = function(block) {
+  // Prompt function (internal message).
+  var msg = Blockly.PHP.quote_(block.getFieldValue('TEXT'));
+  var code = 'readline(' + msg + ')';
+  var toNumber = block.getFieldValue('TYPE') == 'NUMBER';
+  if (toNumber) {
+    code = 'floatval(' + code + ')';
+  }
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};
+
+Blockly.PHP['text_prompt_ext'] = function(block) {
+  // Prompt function (external message).
+  var msg = Blockly.PHP.valueToCode(block, 'TEXT',
+      Blockly.PHP.ORDER_NONE) || '\'\'';
+  var code = 'readline(' + msg + ')';
+  var toNumber = block.getFieldValue('TYPE') == 'NUMBER';
+  if (toNumber) {
+    code = 'floatval(' + code + ')';
+  }
+  return [code, Blockly.PHP.ORDER_FUNCTION_CALL];
+};

generators/php/variables.js

+/**
+ * @license
+ * Visual Blocks Language
+ *
+ * Copyright 2012 Google Inc.
+ * https://developers.google.com/blockly/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Generating PHP for variable blocks.
+ * @author daarond@gmail.com (Daaron Dwyer)
+ */
+'use strict';
+
+goog.provide('Blockly.PHP.variables');
+
+goog.require('Blockly.PHP');
+
+
+Blockly.PHP['variables_get'] = function(block) {
+  // Variable getter.
+  var code = Blockly.PHP.variableDB_.getName(block.getFieldValue('VAR'),
+      Blockly.Variables.NAME_TYPE);
+  return [code, Blockly.PHP.ORDER_ATOMIC];
+};
+
+Blockly.PHP['variables_set'] = function(block) {
+  // Variable setter.
+  var argument0 = Blockly.PHP.valueToCode(block, 'VALUE',
+      Blockly.PHP.ORDER_ASSIGNMENT) || '0';
+  var varName = Blockly.PHP.variableDB_.getName(
+      block.getFieldValue('VAR'), Blockly.Variables.NAME_TYPE);
+  return '$' + varName + ' = ' + argument0 + ';\n';
+};

tests/playground.html

@@ -13,6 +13,15 @@
 <script src="../generators/javascript/colour.js"></script>
 <script src="../generators/javascript/variables.js"></script>
 <script src="../generators/javascript/procedures.js"></script>
+<script src="../generators/php.js"></script>
+<script src="../generators/php/logic.js"></script>
+<script src="../generators/php/loops.js"></script>
+<script src="../generators/php/math.js"></script>
+<script src="../generators/php/text.js"></script>
+<script src="../generators/php/lists.js"></script>
+<script src="../generators/php/colour.js"></script>
+<script src="../generators/php/variables.js"></script>
+<script src="../generators/php/procedures.js"></script>
 <script src="../generators/python.js"></script>
 <script src="../generators/python/logic.js"></script>
 <script src="../generators/python/loops.js"></script>
@@ -436,6 +445,8 @@ h1 {
     <br>
     <input type="button" value="To JavaScript" onclick="toCode('JavaScript')">
     &nbsp;
+    <input type="button" value="To PHP" onclick="toCode('PHP')">
+    &nbsp;
     <input type="button" value="To Python" onclick="toCode('Python')">
     &nbsp;
     <input type="button" value="To Dart" onclick="toCode('Dart')">