PHP

Notes on what appears to be common (and best) practices when writing a PHP library.

What's the best way to write a PHP library? The conventional wisdom seems to be:

    • create a class, not just functions

    • constructor takes application keys as the parameters

    • class method names should closely match the names of endpoint URLs

    • use PHP arrays or objects as the methods' return values then unserialize (at least that's what I do) when possible

      • other than the LongURL web service's API that I wrote a library for, I haven't seen an API that returns PHP in the same way

      • arrays or objects? Closely match what the API gives you? For example, if it's JSON or XML, return objects?

      • if it's XML, SimpleXML objects are more difficult to address than StdClas() objects. What to do then?

      • should we prefer JSON from the API itself? JSONP? What if the JSON returns a callback which we can't turn off? One Stack Overflow post recommends str_replace() if that's the case, but that's messy!