/* * Copyright (C)2005-2017 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 inline function objectOfAssociativeArray(arr : NativeArray) : Dynamic { 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: * * @param to * @param subject * @param message * @param ?additionalHeaders * @param ?additionalParameters */ public static inline function mail(to : String, subject : String, message : String, ?additionalHeaders : String, ?additionalParameters : String) : Bool { return Global.mail(to, subject, message, additionalHeaders, additionalParameters); } /** For neko compatibility only. **/ public static inline function rethrow( e : Dynamic ) { throw e; } /** Tries to load all compiled php files and returns list of tpes. **/ 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.getField(obj, pack) == null) { Syntax.setField(obj, pack, {}); } obj = Syntax.getField(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); }); } }