PHP usage examples

/ping @bjori @derickr: let's discuss the BC issues mentioned in the comments later this week