The Underground PHP and Oracle Manual
- Product:
- Oracle Database
- Document Type:
- Published Book
- Version:
- Release 2.0
- Last Publish Date:
- December 2012
- Tools Used:
- FrameMaker
Overview
The Underground PHP and Oracle Manual is a comprehensive 350+ page technical book co-authored with Christopher Jones, published by Oracle Corporation and distributed freely to the developer community. This book serves as the definitive guide for PHP developers working with Oracle Database, covering everything from basic connectivity to advanced features like connection pooling, high availability, and application performance tuning.
Target Audience
PHP developers learning Oracle Database integration, Oracle developers adopting PHP for application development, system administrators deploying PHP-Oracle stacks, architects designing scalable PHP applications with Oracle, and students and educators teaching PHP and database integration.
Co-Author Role
As co-author alongside Christopher Jones (Principal Product Manager for PHP and Oracle Database technologies), I was responsible for writing and editing multiple chapters covering database installation, SQL tools, globalization, and testing, coordinating contributions from over 25 Oracle engineers and external experts, ensuring technical accuracy through hands-on testing of all code examples, structuring content for both novice and advanced developers, and creating practical, working examples throughout the book.
Key Content Coverage
The manual covers the complete PHP-Oracle development stack across 19 comprehensive chapters including foundation chapters (introduction, getting started, PHP Oracle extensions), installation and setup (Oracle Database 11g XE, Apache HTTP Server, PHP on Linux/Windows/Solaris), database development tools (SQL*Plus, Oracle Application Express, SQL Developer, NetBeans IDE), core PHP and Oracle development (connecting with OCI8, executing SQL, using PL/SQL, working with LOBs, XML integration), and advanced topics (connection pooling, high availability, TimesTen, Tuxedo, globalization, testing).
Documentation Challenges
Challenge 1: Bridging Two Technical Communities
The book needed to serve both PHP developers new to Oracle and Oracle developers new to PHP. Each community had different knowledge bases, terminology, and expectations.
Solution: Structured the book with progressive complexity. Early chapters assume minimal knowledge of either technology, while later chapters dive deep into advanced features. Included extensive cross-references and a comprehensive glossary.
Challenge 2: Multi-Platform Coverage
PHP and Oracle run on numerous platforms (Linux variants, Windows, Oracle Solaris, Mac OS X), each with different installation procedures and operational characteristics.
Solution: Created platform-specific installation chapters with detailed procedures for each major platform. Used conditional explanations throughout to highlight platform-specific considerations. All code examples were tested on multiple platforms.
Challenge 3: Coordinating Multiple Contributors
With over 25 contributors providing content on specialized topics, maintaining consistent voice, style, and technical depth was challenging.
Solution: Established editorial guidelines for structure, tone, and code formatting. Performed comprehensive technical and editorial review of all contributed content. Rewrote sections as needed to ensure consistency.
Community Impact
The book has had significant impact with thousands of downloads from the Oracle Technology Network since publication, community adoption as the reference guide for PHP-Oracle development, reduced barrier to entry for PHP developers adopting Oracle Database, and frequent citations in technical forums and developer blogs. The freely available distribution model significantly expanded Oracle’s reach in the PHP developer community.