226 PHP equivalents

PHP to Javascript Project: php.js

php.js This article is part of the 'Porting PHP to Javascript' Project, which aims to decrease the gap between developing for PHP & Javascript.

A lot of people are familiar with PHP's functions, and though Javascript functions are often quite similar, some functions may be missing or addressed differently. The Javascript implementations should be as compliant with the PHP versions as possible, a good indication is that the PHP function manual could also apply to the Javascript version.

Porting crucial PHP functions to Javascript can be fun & useful. Currently some PHP functions have been added, but readers are encouraged to contribute and improve functions by adding comments. Eventually the goal is to save all the functions in one php.js file and make it publicly available for your coding pleasure.

If you choose to contribute, let me know how you want to be credited in the function's comments. You may also want to subscribe to RSS so you receive updates whenever new functions are posted.

This is a Javascript version of the PHP function: array_slice.

PHP array_slice

Description

array_slice - Extract a slice of the array

array array_slice( array array , int offset [, int length [, bool preserve_keys]] )

arrayThe input array.

Parameters

array
The input array.
offset
If offset is non-negative, the sequence will start at that offset in the array . If offset is negative, the sequence will start that far from the end of the array .
length
If length is given and is positive, then the sequence will have that many elements in it. If length is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from offset up until the end of the array .
preserve_keys
Note that array_slice() will reorder and reset the array indices by default. You can change this behaviour by setting preserve_keys to TRUE.

Return Values

Returns the slice.

Javascript array_slice

Source

This is the main source of the Javascript version of PHP's array_slice

function array_slice(arr, offst, lgth, preserve_keys) {
    // http://kevin.vanzonneveld.net
    // +   original by: Brett Zamir
    // -    depends on: is_int
    // %          note: Relies on is_int because !isNaN accepts floats 
    // *     example 1: array_slice(["a", "b", "c", "d", "e"], 2, -1);
    // *     returns 1: {0: 'c', 1: 'd'}
    // *     example 2: array_slice(["a", "b", "c", "d", "e"], 2, -1, true);
    // *     returns 2: {2: 'c', 3: 'd'}
 
    /*
    if ('callee' in arr && 'length' in arr) {
        arr = Array.prototype.slice.call(arr);
    }
    */
 
  if (!(arr instanceof Array) || (preserve_keys && offst != 0)) { // Assoc. array as input or if required as output
    var lgt =0, newAssoc = {};
    for (var key in arr) {
      //if (key !== 'length') {
        lgt += 1;
        newAssoc[key] = arr[key];
      //}
    }
    arr = newAssoc;
    
    offst = (offst < 0) ? lgt + offst : offst;
    lgth  = lgth == undefined ? lgt : (lgth < 0) ? lgt + lgth - offst : lgth;
    
    var assoc = {};
    var start = false, it=-1, arrlgth=0, no_pk_idx=0;
    for (var key in arr) {
        ++it;
        if (arrlgth >= lgth) {
          break;
        }
        if (it == offst){
          start = true;
        }
        if (!start) {
           continue;
        }
        ++arrlgth;
        if (is_int(key) && !preserve_keys) {
                assoc[no_pk_idx++] = arr[key];
        } else {
            assoc[key] = arr[key];
        }
    }
    //assoc.length = arrlgth; // Make as array-like object (though length will not be dynamic)
    return assoc;
  }
    
    if (lgth === undefined) {
        return arr.slice(offst);    
    } else if (lgth >= 0) {
        return arr.slice(offst, offst + lgth);
    } else {
        return arr.slice(offst, lgth);
    }
    
}

To run the Javascript array_slice, you will also need the following dependencies:

is_int

Examples

Currently there are 2 examples

Example 1

This is how you could call array_slice()

array_slice(["a", "b", "c", "d", "e"], 2, -1);

And that would return

{0: 'c', 1: 'd'}

Example 2

This is how you could call array_slice()

array_slice(["a", "b", "c", "d", "e"], 2, -1, true);

And that would return

{2: 'c', 3: 'd'}

More about this Project

Download php.js

To easily include it in your code, every function currently available is stored in

Normal

uncompressed source: php.js (257.1kB)
minified: php.min.js (84.4kB) [recommended]
compressed: php.packed.js (60kB)

Namespaced What is 'namespaced?'

uncompressed source: php.namespaced.js (317.6kB)
minified: php.namespaced.min.js (84.7kB)
compressed: php.namespaced.packed.js (60.4kB)

To download use Right click, Save Link As
Generally the best way is to use a minified version and gzip it

Credits

Respect & awards go to everybody who has contributed in some way so far:

	Onno Marsman for contributing to:
	acos, acosh, asin, asinh, atan, atanh, ceil, cos, cosh, decbin, dechex, decoct, exp, floor, fmod, getrandmax, hypot, is_finite, is_infinite, is_nan, lcg_value, log, log10, max, max, min, min, mt_getrandmax, mt_rand, pi, pow, rand, round, sin, sinh, sqrt, tan, tanh, setcookie, preg_quote, addslashes, bin2hex, count_chars, html_entity_decode, htmlentities, htmlspecialchars_decode, levenshtein, ltrim, nl2br, nl2br, ord, parse_str, rtrim, soundex, str_ireplace, str_replace, str_replace, str_rot13, str_split, strcasecmp, strip_tags, stripos, stripslashes, stristr, strlen, strnatcmp, strncasecmp, strpbrk, strpos, strrev, strripos, strrpos, strstr, strtolower, strtoupper, substr, substr_count, trim, ucfirst, ucwords, base64_decode, empty, empty, is_array, is_bool, isset, utf8_decode, utf8_encode, utf8_encode
	Brett Zamir for contributing to:
	array_fill_keys, array_fill_keys, array_filter, array_merge, array_slice, array_splice, class_exists, method_exists, property_exists, call_user_func, call_user_func_array, func_get_arg, func_get_args, func_num_args, get_defined_functions, get_defined_functions, die, exit, str_split, strspn, get_defined_vars
	Michael White (link) for contributing to:
	array_count_values, get_included_files, include, include_once, require, require_once, md5, number_format, parse_str, printf, sha1, sprintf, str_pad, strnatcmp, http_build_query, floatval, is_object, print_r
	Paulo Ricardo F. Santos for contributing to:
	chunk_split, getdate, microtime, constant, define, chop, quotemeta, sprintf, get_headers, gettype, is_double, is_float, is_integer, is_long, is_scalar
	Waldo Malqui Silva for contributing to:
	array_fill, array_pad, array_product, array_rand, compact, count, range, abs, defined, ip2long, long2ip, implode, strcmp, ucwords
	Jack for contributing to:
	compact, max, min, count_chars, htmlentities, md5, parse_str, soundex, sprintf, str_ireplace, strnatcmp, trim, utf8_encode
	Jonas Raoni Soares Silva (link) for contributing to:
	shuffle, abs, setcookie, number_format, number_format, soundex, str_repeat, str_replace, str_rot13, ucwords, wordwrap, wordwrap
	Philip Peterson for contributing to:
	sizeof, log10, round, echo, get_html_translation_table, nl2br, str_replace, strchr, urldecode, urlencode, var_export
	Ates Goral (link) for contributing to:
	array_change_key_case, array_count_values, array_diff_key, each, get_class, preg_quote, addslashes, count_chars, str_rot13, stripslashes
	Legaev Andrey for contributing to:
	end, reset, file, file_get_contents, function_exists, include, include_once, http_build_query, is_array, is_object
	Martijn Wieringa for contributing to:
	array_shift, array_unshift, str_ireplace, str_split, strcasecmp, stripos, strnatcmp, substr
	Enrique Gonzalez for contributing to:
	file_exists, filesize, decbin, decoct, deg2rad, rad2deg
	Nate for contributing to:
	array_merge, array_sum, array_unique, addslashes, echo, strncasecmp
	Philippe Baumann for contributing to:
	base_convert, bindec, dechex, hexdec, octdec, empty
	Webtoolkit.info (link) for contributing to:
	crc32, md5, sha1, utf8_decode, utf8_encode

	Carlos R. L. Rodrigues (link) for contributing to:
	array_chunk, array_unique, date, levenshtein
	Jani Hartikainen for contributing to:
	file, file_exists, file_get_contents, filesize
	Ash Searle (link) for contributing to:
	basename, printf, sprintf
	Erkekjetter for contributing to:
	ltrim, rtrim, trim
	GeekFG (link) for contributing to:
	krsort, ksort, time
	Johnny Mast (link) for contributing to:
	array_walk, array_walk_recursive, create_function
	d3x for contributing to:
	array, explode, unserialize
	marrtins for contributing to:
	array_change_key_case, addslashes, stripslashes
	AJ for contributing to:
	urldecode, urlencode
	Alex for contributing to:
	strip_tags, is_int
	Alfonso Jimenez (link) for contributing to:
	array_reduce, strpbrk
	Aman Gupta for contributing to:
	base64_decode, utf8_decode
	Arpad Ray (mailto:arpad@php.net) for contributing to:
	serialize, unserialize
	Karol Kowalski for contributing to:
	array_reverse, abs
	Mirek Slugen for contributing to:
	htmlspecialchars, htmlspecialchars_decode
	Sakimori for contributing to:
	strlen, wordwrap
	Thunder.m for contributing to:
	base64_decode, base64_encode
	Tyler Akins (link) for contributing to:
	base64_decode, base64_encode
	mdsjack (link) for contributing to:
	include, trim
	0m3r for contributing to:
	array_diff_assoc
	Alexander Ermolaev (link) for contributing to:
	trim
	Allan Jensen (link) for contributing to:
	number_format
	Andrea Giammarchi (link) for contributing to:
	array_map
	Andreas for contributing to:
	setcookie
	Andrej Pavlovic for contributing to:
	serialize
	Anton Ongson for contributing to:
	str_replace
	Arno for contributing to:
	htmlspecialchars
	Atli Þór for contributing to:
	nl2br
	Bayron Guevara for contributing to:
	base64_encode
	Ben Bryan for contributing to:
	print_r
	Benjamin Lupton for contributing to:
	number_format
	Brad Touesnard for contributing to:
	date
	Cagri Ekin for contributing to:
	parse_str
	Caio Ariede (link) for contributing to:
	strtotime
	Christian Doebler for contributing to:
	sleep
	Cord for contributing to:
	is_array
	David for contributing to:
	is_numeric
	David James for contributing to:
	get_class
	Dino for contributing to:
	serialize
	Douglas Crockford (link) for contributing to:
	gettype
	DxGx for contributing to:
	trim
	FGFEmperor for contributing to:
	mktime
	Felix Geisendoerfer (link) for contributing to:
	array_key_exists
	Francesco for contributing to:
	empty
	Francois for contributing to:
	htmlspecialchars_decode
	FremyCompany for contributing to:
	isset
	Gabriel Paderni for contributing to:
	str_replace
	Garagoth for contributing to:
	serialize
	Howard Yeend for contributing to:
	number_format
	J A R for contributing to:
	end
	Kirk Strobeck for contributing to:
	strlen
	LH for contributing to:
	empty
	Leslie Hoare for contributing to:
	rand
	Lincoln Ramsay for contributing to:
	basename
	Linuxworld for contributing to:
	bin2hex
	Luke Godfrey for contributing to:
	strip_tags
	Manish for contributing to:
	is_array
	Marc Palau for contributing to:
	strip_tags
	Mateusz "loonquawl" Zalega for contributing to:
	htmlspecialchars_decode
	MeEtc (link) for contributing to:
	date
	Mick@el for contributing to:
	stripslashes
	Nathan for contributing to:
	htmlspecialchars
	Nick Callen for contributing to:
	wordwrap
	Norman "zEh" Fuchs for contributing to:
	utf8_decode
	Ozh for contributing to:
	dirname
	Pedro Tainha (link) for contributing to:
	unserialize
	Peter-Paul Koch (link) for contributing to:
	date
	Pul for contributing to:
	strip_tags
	Pyerre for contributing to:
	checkdate
	ReverseSyntax for contributing to:
	htmlspecialchars_decode
	Robin for contributing to:
	is_nan
	Sanjoy Roy for contributing to:
	array_diff
	Saulo Vallory for contributing to:
	strncasecmp
	Scott Cariss for contributing to:
	htmlspecialchars_decode
	Simon Willison (link) for contributing to:
	str_replace
	Slawomir Kaniecki for contributing to:
	htmlspecialchars_decode
	Steve Clay for contributing to:
	function_exists
	Steve Hilder for contributing to:
	strcmp
	Steven Levithan (link) for contributing to:
	trim
	Subhasis Deb for contributing to:
	array_merge_recursive
	T. Wild for contributing to:
	filesize
	T.Wild for contributing to:
	substr
	T0bsn for contributing to:
	crc32
	Thiago Mata (link) for contributing to:
	call_user_func_array
	Tim Wiel for contributing to:
	date
	Tod Gentille for contributing to:
	log10
	Valentina De Rosa for contributing to:
	strspn
	XoraX (link) for contributing to:
	dirname
	Yannoo for contributing to:
	mktime
	Yves Sucaet for contributing to:
	utf8_encode
	baris ozdil for contributing to:
	mktime
	booeyOH for contributing to:
	preg_quote
	djmix for contributing to:
	basename
	dptr1988 for contributing to:
	unserialize
	duncan for contributing to:
	array_unique
	echo is bad for contributing to:
	echo
	gabriel paderni for contributing to:
	mktime
	ger for contributing to:
	html_entity_decode
	gorthaur for contributing to:
	strcmp
	hitwork for contributing to:
	utf8_decode
	jakes for contributing to:
	mktime
	john (link) for contributing to:
	html_entity_decode
	johnrembo for contributing to:
	var_export
	kenneth for contributing to:
	explode
	marc andreu for contributing to:
	html_entity_decode
	metjay for contributing to:
	time
	nobbler for contributing to:
	htmlentities
	noname for contributing to:
	get_html_translation_table
	penutbutterjelly for contributing to:
	str_ireplace
	rezna for contributing to:
	stripslashes
	sankai for contributing to:
	array_count_values
	sowberry for contributing to:
	utf8_encode
	stensi for contributing to:
	intval

Your name here?

Contributing is as easy as adding a comment with better code, or code for a new function.
Any contribution leading to improvement will directly get your name & link here.

Coming Project features

Project features that we are currently working on:

Site. A place for php.js of it's own. You can track our lame attempts at phpjs.org. If there are any CakePHP developers out there who would like to help out, please contact me.
Compile. Compile your own php.js version, with only the functions you need. Should generate a hash with which you can retrieve latest versions of your php.js combination.
docBlock. Move to docBlock comments for improved compatibility with IDEs.
Done - Testsuite. A better test-suite that can be ran locally so developers can easily test before commiting. Also the testing itself should be more thorough.
Done - Versioning. Individual functions are versioned, but the entire library should be versioned as well.

Like this article?

Then Dzone it!
Or use another bookmark button below to show your support &
help me spread the word.

Kevin van Zonneveld

IT related articles & howtos

» Javascript equivalent for PHP's array_slice