Actually, I disagree completely. I think this is one of the best APIs
I have seen. And the documentation is better than most. If you are
having problems understanding a particular part of the API, you should
post specific questions.
I am currently implementing my own data source for serving data to a
visualization from a SQL database and it is simpler than I would have
thought. However, I'm coming from a Java background, and I'm not
familiar with PHP so maybe its a "cultural" thing... If you are
familiar with using J2EE webapps (war), its very easy to put a servlet
stack that will serve your data from any SQL table. Not sure how you
would do this from other web app containers.
If you are having trouble understanding how the Visualization API
works, I suggest you start serving a JSON dataTable directly to your
visualization, before you start messing with the Data Source API.