» PHP.JS Licensing

134 PHP equivalents

PHP to Javascript Project: php.js

php.jsThis 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.

Licensing

Since the project is really kicking off and we're almost at 100 ported functions, I thought it was probably time to think about licensing. So I did a little bit of research, and I think the MIT license might be what we're looking for.

In short, it permits reuse within proprietary software on the condition that the license is distributed with that software. It's also GPL-compatible, meaning that the GPL permits combination and redistribution with software that uses the MIT License.

The license

This is what I've come up with so far:

/* 
 * More info at: http://kevin.vanzonneveld.net/techblog/category/php2js
 * 
 * php.js is copyright 2008 Kevin van Zonneveld.
 * 
 * Portions copyright Ates Goral (http://magnetiq.com), Legaev Andrey,
 * _argos, Jonas Raoni Soares Silva (http://www.jsfromhell.com),
 * Webtoolkit.info (http://www.webtoolkit.info/), Carlos R. L. Rodrigues, Ash
 * Searle (http://hexmen.com/blog/), Tyler Akins (http://rumkin.com), mdsjack
 * (http://www.mdsjack.bo.it), Alexander Ermolaev
 * (http://snippets.dzone.com/user/AlexanderErmolaev), Andrea Giammarchi
 * (http://webreflection.blogspot.com), Bayron Guevara, Cord, David, Karol
 * Kowalski, Leslie Hoare, Lincoln Ramsay, Mick@el, Nick Callen, Peter-Paul
 * Koch (http://www.quirksmode.org/js/beat.html), Philippe Baumann, Steve
 * Clay, booeyOH
 * 
 * Licensed under the MIT (MIT-LICENSE.txt) license.
 * 
 * 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 KEVIN VAN ZONNEVELD 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.
 */

The "Portions copyright" section is updated autmatically as we update the source files.

Got ideas?

If any of  you have different ideas about this license, please let me know, because this is  an initial draft.

New to php.js ?

If you're new to php.js, checkout an example. We are not trying to port or emulate the entire language or control structures of PHP. We don't see the need because Javascript seems to have more elegant features in that category anyway.

However in our eyes, PHP does provide a large set of standard functions that make developing very easy, and some of them don't have good standard Javascript implementations, though they often would be great to have client-side.

So in this project by also providing the functions separately, we hope to keep people from inventing the wheel and give them a head start.


Like this article?

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


Hot Stuff

Flaming articles

» Survive heavy traffic with you...
» Upgrade to Ubuntu Gutsy with C...
» Change more display settings i...
» Create your own screencast
» List of social bookmarking sites

Related

Articles like this one

» Javascript equivalent for PHP'...
» Javascript equivalent for PHP'...
» PHP.JS Namespaced
» PHP.JS SVN
» Javascript equivalent for PHP'...

tags: programming, javascript, php, phpjs
category: Programming - Javascript - PHP equivalents
read: 11,330 times

Add comment

for syntax highlighting

[CODE="Javascript"]
your_code_here();
[/CODE]

Replace "Javascript"
with "php", "text", etc.code (to make sure you are not a spammer)

Comments

#16. is_array on 07 May 2008

is_arrayis_array

#15. Shane on 06 May 2008

ShaneBeautiful! <3

#14. Kevin on 28 April 2008

Kevin@ Ozh: Very good work indeed! I added 2 example test cases from the PHP manual and they both work out perfectly. Thanks a lot Ozh!

#13. Ozh on 28 April 2008

OzhAwesome stuff! I have a proposal for dirname() : 

function dirname(path) {
    return path.replace(/\\/g,'/').replace(/\/[^\/]*$/, '');;
}

#12. Kevin on 21 April 2008

Kevin@ PhenX: We could not agree more and are currently working on a dedicated php.js site. I'll announce it on my blog when it's ready, then further developments will be updated there.

Thanks for sharing & taking an interest in our project!

#11. PhenX on 21 April 2008

PhenXThis projetc has been added to Ohloh :
http://www.ohloh.net/projects/php-js
We hope it will help :)
It would be nice to have a page completely dedicated to news and file downloads to be easier to find what we want. For now, it's hard to navigate into a blog for such a project

#10. Felix Geisendörfer on 06 April 2008

Felix GeisendörferHey Kevin,

I'm currently working on a book called "JavaScript for PHP developers" and I see a lot of overlap between the work I'm doing and your efforts here.

So I'd love to have a little chat about how I may be able to help with your project. Contact me on felix@debuggable.com or any of the instant messagers listed here: debuggable.com/felix
... [more]
Thanks for the great work so far.
-- Felix

#9. Kevin on 20 March 2008

Kevin@ Tim: Thanks for taking an interest! What you've started is actually one of our next big 3 todo's. We're going to build a tool with predefined profiles in a selectbox, and a lot of checkboxes, just like many codec installers out there.

It should have auto-dependency resolving, optional packing or minifying, etc.

About your question, I'm in the midst of moving php.js to SVN, after that, the master file will have versioning as well. Currently only the separate function files have versions.

#8. Tim on 19 March 2008

TimThis is awesome - finally making JS something I like dealing with.

I built a little script to make adding just parts of this great library available for download (packed with Dean Edwards packer). You can check it out at http://sitebytim.com/code/php_equivalents/ - FYI it's pretty rough at the moment so I hope to clean it up a little bit but it does the trick for what I need.

Just curious - if the individual files that have a single function (linked too from your testing page) are the same version as the functions included in the master php.js file?

#7. Kevin on 07 February 2008

Kevin@Jean-Lou Dupont: All of the individual functions are versioned but you make a good point and I will take a look at implementing it (probably) next weekend. Thanks for the comment!

#6. Jean-Lou Dupont on 06 February 2008

Jean-Lou DupontHave you considered versioning your 'php.js' file?

#5. Kevin on 04 February 2008

KevinI've asked the registrant of phpjs.com if he would be willing to transfer that domain name to us.

And though he already has made plans for www.phpjs.com to create a blog about working with symfony and dojo on web applications, I received a nice mail that he will still consider the transfer if he doesn't have enough time to kickstart that project.

We will be hearing from him next month.

#4. Kevin on 01 February 2008

Kevin@ Karol Kowalski: Yeah thought about that. Though I'm happy with the low-maintenance requirements of this method, it's probably best to provide php.js with a face of it's own. Anyone got a catchy domainname? ;)

Unfortunately my whois tells me there is no .js TLD.
I don't think PHP would appreciate a www.php.js domainname either ;)

#3. Kevin on 01 February 2008

Kevin@ Legaev Andrey: OK thanks. I've thought about GPL as well, because it forces others to open up their software as well.
Whereas MIT is cool with it if you incorporate & change php.js in your own app without ever exposing your improvements to the public.

But obviously, that does provide greater freedom.

#2. Karol Kowalski on 01 February 2008

Karol KowalskiSeems like it't time to move the project out of your blog then:-)

#1. Legaev Andrey on 01 February 2008

Legaev AndreyI agree with your choice of the license.