/* * Copyright (C)2005-2019 Haxe Foundation * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. */ package php; import haxe.ds.StringMap; import php.*; import php.reflection.ReflectionClass; /** Platform-specific PHP Library. Provides some platform-specific functions for the PHP target, such as conversion from Haxe types to native types and vice-versa. **/ class Lib { /** Print the specified value on the default output. **/ public static inline function print(v:Dynamic):Void { Global.echo(Std.string(v)); } /** Print the specified value on the default output followed by a newline character. **/ public static function println(v:Dynamic):Void { print(v); print("\n"); } /** Displays structured information about one or more expressions that includes its type and value. Arrays and objects are explored recursively with values indented to show structure. **/ public static inline function dump(v:Dynamic):Void { Global.var_dump(v); } /** Serialize using native PHP serialization. This will return a binary `String` that can be stored for long term usage. **/ public static inline function serialize(v:Dynamic):String { return Global.serialize(v); } /** Unserialize a `String` using native PHP serialization. See `php.Lib.serialize()`. **/ public static inline function unserialize(s:String):Dynamic { return Global.unserialize(s); } /** Find out whether an extension is loaded. **/ public static inline function extensionLoaded(name:String) { return Global.extension_loaded(name); } public static inline function isCli():Bool { return 0 == Global.strncasecmp(Const.PHP_SAPI, 'cli', 3); } /** Output file content from the given file name. **/ public static inline function printFile(file:String) { return Global.fpassthru(Global.fopen(file, "r")); } public static inline function toPhpArray(a:Array):NativeArray { return @:privateAccess a.arr; } public static inline function toHaxeArray(a:NativeArray):Array { return @:privateAccess Array.wrap(a); } public static function hashOfAssociativeArray(arr:NativeAssocArray):Map { var result = new StringMap(); @:privateAccess result.data = arr; return result; } public static inline function associativeArrayOfHash(hash:haxe.ds.StringMap):NativeArray { return @:privateAccess hash.data; } public static function objectOfAssociativeArray(arr:NativeArray):Dynamic { Syntax.foreach(arr, function(key:Scalar, value:Dynamic) { if (Global.is_array(value)) { arr[key] = objectOfAssociativeArray(value); } }); return Boot.createAnon(arr); } public static inline function associativeArrayOfObject(ob:Dynamic):NativeArray { return Syntax.array(ob); } /** See the documentation for the equivalent PHP function for details on usage: **/ public static inline function mail(to:String, subject:String, message:String, ?additionalHeaders:String, ?additionalParameters:String):Bool { return Global.mail(to, subject, message, additionalHeaders, additionalParameters); } /** Rethrows an exception. If `e` is not a value caught in `try...catch` or if called outside of `catch` block, then `e` is thrown as a new exception. **/ extern public static inline function rethrow(e:Dynamic) { if (Syntax.code("isset($__hx__caught_e, $__hx__real_e)") && e == Syntax.code("$__hx__real_e")) { Syntax.code("throw $__hx__caught_e"); } throw e; } /** Tries to load all compiled php files and returns list of types. **/ public static function getClasses():Dynamic { if (!loaded) { loaded = true; var reflection = new ReflectionClass(Boot.getPhpName('php.Boot')); loadLib(Global.dirname(reflection.getFileName(), 2)); } var result:Dynamic = {}; Syntax.foreach(Boot.getRegisteredAliases(), function(phpName:String, haxeName:String) { var parts = haxeName.split('.'); var obj = result; while (parts.length > 1) { var pack = parts.shift(); if (Syntax.field(obj, pack) == null) { Syntax.setField(obj, pack, {}); } obj = Syntax.field(obj, pack); } Syntax.setField(obj, parts[0], Boot.getClass(phpName)); }); return result; } static var loaded:Bool = false; /** Loads types defined in the specified directory. **/ public static function loadLib(pathToLib:String):Void { var absolutePath = Global.realpath(pathToLib); if (absolutePath == false) throw 'Failed to read path: $pathToLib'; Syntax.foreach(Global.glob('$absolutePath/*.php'), function(_, fileName) { if (!Global.is_dir(fileName)) { Global.require_once(fileName); } }); Syntax.foreach(Global.glob('$absolutePath/*', Const.GLOB_ONLYDIR), function(_, dirName) { loadLib(dirName); }); } }