mirror of
https://github.com/google/blockly.git
synced 2026-01-04 23:50:12 +01:00
90b3f75d82
Our files are up to a decade old, and have churned so much, that the initial author of the file no longer has much meaning. Furthermore, this will encourage developers to post to the developer group, rather than emailing Googlers (usually me) directly.
304 lines
11 KiB
JavaScript
304 lines
11 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2015 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview Helper functions for generating PHP for blocks.
|
|
*/
|
|
'use strict';
|
|
|
|
goog.provide('Blockly.PHP');
|
|
|
|
goog.require('Blockly.Generator');
|
|
goog.require('Blockly.inputTypes');
|
|
goog.require('Blockly.utils.object');
|
|
goog.require('Blockly.utils.string');
|
|
|
|
|
|
/**
|
|
* 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(
|
|
// 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__'
|
|
);
|
|
|
|
/**
|
|
* Order of operation ENUMs.
|
|
* http://php.net/manual/en/language.operators.precedence.php
|
|
*/
|
|
Blockly.PHP.ORDER_ATOMIC = 0; // 0 "" ...
|
|
Blockly.PHP.ORDER_CLONE = 1; // clone
|
|
Blockly.PHP.ORDER_NEW = 1; // new
|
|
Blockly.PHP.ORDER_MEMBER = 2.1; // []
|
|
Blockly.PHP.ORDER_FUNCTION_CALL = 2.2; // ()
|
|
Blockly.PHP.ORDER_POWER = 3; // **
|
|
Blockly.PHP.ORDER_INCREMENT = 4; // ++
|
|
Blockly.PHP.ORDER_DECREMENT = 4; // --
|
|
Blockly.PHP.ORDER_BITWISE_NOT = 4; // ~
|
|
Blockly.PHP.ORDER_CAST = 4; // (int) (float) (string) (array) ...
|
|
Blockly.PHP.ORDER_SUPPRESS_ERROR = 4; // @
|
|
Blockly.PHP.ORDER_INSTANCEOF = 5; // instanceof
|
|
Blockly.PHP.ORDER_LOGICAL_NOT = 6; // !
|
|
Blockly.PHP.ORDER_UNARY_PLUS = 7.1; // +
|
|
Blockly.PHP.ORDER_UNARY_NEGATION = 7.2; // -
|
|
Blockly.PHP.ORDER_MULTIPLICATION = 8.1; // *
|
|
Blockly.PHP.ORDER_DIVISION = 8.2; // /
|
|
Blockly.PHP.ORDER_MODULUS = 8.3; // %
|
|
Blockly.PHP.ORDER_ADDITION = 9.1; // +
|
|
Blockly.PHP.ORDER_SUBTRACTION = 9.2; // -
|
|
Blockly.PHP.ORDER_STRING_CONCAT = 9.3; // .
|
|
Blockly.PHP.ORDER_BITWISE_SHIFT = 10; // << >>
|
|
Blockly.PHP.ORDER_RELATIONAL = 11; // < <= > >=
|
|
Blockly.PHP.ORDER_EQUALITY = 12; // == != === !== <> <=>
|
|
Blockly.PHP.ORDER_REFERENCE = 13; // &
|
|
Blockly.PHP.ORDER_BITWISE_AND = 13; // &
|
|
Blockly.PHP.ORDER_BITWISE_XOR = 14; // ^
|
|
Blockly.PHP.ORDER_BITWISE_OR = 15; // |
|
|
Blockly.PHP.ORDER_LOGICAL_AND = 16; // &&
|
|
Blockly.PHP.ORDER_LOGICAL_OR = 17; // ||
|
|
Blockly.PHP.ORDER_IF_NULL = 18; // ??
|
|
Blockly.PHP.ORDER_CONDITIONAL = 19; // ?:
|
|
Blockly.PHP.ORDER_ASSIGNMENT = 20; // = += -= *= /= %= <<= >>= ...
|
|
Blockly.PHP.ORDER_LOGICAL_AND_WEAK = 21; // and
|
|
Blockly.PHP.ORDER_LOGICAL_XOR = 22; // xor
|
|
Blockly.PHP.ORDER_LOGICAL_OR_WEAK = 23; // or
|
|
Blockly.PHP.ORDER_NONE = 99; // (...)
|
|
|
|
/**
|
|
* List of outer-inner pairings that do NOT require parentheses.
|
|
* @type {!Array<!Array<number>>}
|
|
*/
|
|
Blockly.PHP.ORDER_OVERRIDES = [
|
|
// (foo()).bar() -> foo().bar()
|
|
// (foo())[0] -> foo()[0]
|
|
[Blockly.PHP.ORDER_MEMBER, Blockly.PHP.ORDER_FUNCTION_CALL],
|
|
// (foo[0])[1] -> foo[0][1]
|
|
// (foo.bar).baz -> foo.bar.baz
|
|
[Blockly.PHP.ORDER_MEMBER, Blockly.PHP.ORDER_MEMBER],
|
|
// !(!foo) -> !!foo
|
|
[Blockly.PHP.ORDER_LOGICAL_NOT, Blockly.PHP.ORDER_LOGICAL_NOT],
|
|
// a * (b * c) -> a * b * c
|
|
[Blockly.PHP.ORDER_MULTIPLICATION, Blockly.PHP.ORDER_MULTIPLICATION],
|
|
// a + (b + c) -> a + b + c
|
|
[Blockly.PHP.ORDER_ADDITION, Blockly.PHP.ORDER_ADDITION],
|
|
// a && (b && c) -> a && b && c
|
|
[Blockly.PHP.ORDER_LOGICAL_AND, Blockly.PHP.ORDER_LOGICAL_AND],
|
|
// a || (b || c) -> a || b || c
|
|
[Blockly.PHP.ORDER_LOGICAL_OR, Blockly.PHP.ORDER_LOGICAL_OR]
|
|
];
|
|
|
|
/**
|
|
* Whether the init method has been called.
|
|
* @type {?boolean}
|
|
*/
|
|
Blockly.PHP.isInitialized = false;
|
|
|
|
/**
|
|
* Initialise the database of variable names.
|
|
* @param {!Blockly.Workspace} workspace Workspace to generate code from.
|
|
*/
|
|
Blockly.PHP.init = function(workspace) {
|
|
// Call Blockly.Generator's init.
|
|
Object.getPrototypeOf(this).init.call(this);
|
|
|
|
if (!this.nameDB_) {
|
|
this.nameDB_ = new Blockly.Names(this.RESERVED_WORDS_, '$');
|
|
} else {
|
|
this.nameDB_.reset();
|
|
}
|
|
|
|
this.nameDB_.setVariableMap(workspace.getVariableMap());
|
|
this.nameDB_.populateVariables(workspace);
|
|
this.nameDB_.populateProcedures(workspace);
|
|
|
|
this.isInitialized = true;
|
|
};
|
|
|
|
/**
|
|
* 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 = Blockly.utils.object.values(this.definitions_);
|
|
// Call Blockly.Generator's finish.
|
|
code = Object.getPrototypeOf(this).finish.call(this, code);
|
|
this.isInitialized = false;
|
|
|
|
this.nameDB_.reset();
|
|
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.
|
|
* @protected
|
|
*/
|
|
Blockly.PHP.quote_ = function(string) {
|
|
string = string.replace(/\\/g, '\\\\')
|
|
.replace(/\n/g, '\\\n')
|
|
.replace(/'/g, '\\\'');
|
|
return '\'' + string + '\'';
|
|
};
|
|
|
|
/**
|
|
* Encode a string as a properly escaped multiline PHP string, complete with
|
|
* quotes.
|
|
* @param {string} string Text to encode.
|
|
* @return {string} PHP string.
|
|
* @protected
|
|
*/
|
|
Blockly.PHP.multiline_quote_ = function (string) {
|
|
var lines = string.split(/\n/g).map(this.quote_);
|
|
// Join with the following, plus a newline:
|
|
// . "\n" .
|
|
// Newline escaping only works in double-quoted strings.
|
|
return lines.join(' . \"\\n\" .\n');
|
|
};
|
|
|
|
/**
|
|
* 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.
|
|
* @param {boolean=} opt_thisOnly True to generate code for only this statement.
|
|
* @return {string} PHP code with comments and subsequent blocks added.
|
|
* @protected
|
|
*/
|
|
Blockly.PHP.scrub_ = function(block, code, opt_thisOnly) {
|
|
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) {
|
|
comment = Blockly.utils.string.wrap(comment, this.COMMENT_WRAP - 3);
|
|
commentCode += this.prefixLines(comment, '// ') + '\n';
|
|
}
|
|
// Collect comments for all value arguments.
|
|
// Don't collect comments for nested statements.
|
|
for (var i = 0; i < block.inputList.length; i++) {
|
|
if (block.inputList[i].type === Blockly.inputTypes.VALUE) {
|
|
var childBlock = block.inputList[i].connection.targetBlock();
|
|
if (childBlock) {
|
|
comment = this.allNestedComments(childBlock);
|
|
if (comment) {
|
|
commentCode += this.prefixLines(comment, '// ');
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
var nextBlock = block.nextConnection && block.nextConnection.targetBlock();
|
|
var nextCode = opt_thisOnly ? '' : this.blockToCode(nextBlock);
|
|
return commentCode + code + nextCode;
|
|
};
|
|
|
|
/**
|
|
* Gets a property and adjusts the value while taking into account indexing.
|
|
* @param {!Blockly.Block} block The block.
|
|
* @param {string} atId The property ID of the element to get.
|
|
* @param {number=} opt_delta Value to add.
|
|
* @param {boolean=} opt_negate Whether to negate the value.
|
|
* @param {number=} opt_order The highest order acting on this value.
|
|
* @return {string|number}
|
|
*/
|
|
Blockly.PHP.getAdjusted = function(block, atId, opt_delta, opt_negate,
|
|
opt_order) {
|
|
var delta = opt_delta || 0;
|
|
var order = opt_order || this.ORDER_NONE;
|
|
if (block.workspace.options.oneBasedIndex) {
|
|
delta--;
|
|
}
|
|
var defaultAtIndex = block.workspace.options.oneBasedIndex ? '1' : '0';
|
|
if (delta > 0) {
|
|
var at = this.valueToCode(block, atId,
|
|
this.ORDER_ADDITION) || defaultAtIndex;
|
|
} else if (delta < 0) {
|
|
var at = this.valueToCode(block, atId,
|
|
this.ORDER_SUBTRACTION) || defaultAtIndex;
|
|
} else if (opt_negate) {
|
|
var at = this.valueToCode(block, atId,
|
|
this.ORDER_UNARY_NEGATION) || defaultAtIndex;
|
|
} else {
|
|
var at = this.valueToCode(block, atId, order) ||
|
|
defaultAtIndex;
|
|
}
|
|
|
|
if (Blockly.isNumber(at)) {
|
|
// If the index is a naked number, adjust it right now.
|
|
at = Number(at) + delta;
|
|
if (opt_negate) {
|
|
at = -at;
|
|
}
|
|
} else {
|
|
// If the index is dynamic, adjust it in code.
|
|
if (delta > 0) {
|
|
at = at + ' + ' + delta;
|
|
var innerOrder = this.ORDER_ADDITION;
|
|
} else if (delta < 0) {
|
|
at = at + ' - ' + -delta;
|
|
var innerOrder = this.ORDER_SUBTRACTION;
|
|
}
|
|
if (opt_negate) {
|
|
if (delta) {
|
|
at = '-(' + at + ')';
|
|
} else {
|
|
at = '-' + at;
|
|
}
|
|
var innerOrder = this.ORDER_UNARY_NEGATION;
|
|
}
|
|
innerOrder = Math.floor(innerOrder);
|
|
order = Math.floor(order);
|
|
if (innerOrder && order >= innerOrder) {
|
|
at = '(' + at + ')';
|
|
}
|
|
}
|
|
return at;
|
|
};
|