Practical mod_ṗerl

Cover......Page 1
Title......Page 2
Copyright......Page 5
Table of Contents......Page 6
Preface......Page 16
Part I. mod_perl Administration......Page 30
A Brief History of CGI......Page 32
The Apache 1.3 Server Model......Page 42
The Development of mod_perl 1.0......Page 44
Apache 1.3 Request Processing Phases......Page 49
References......Page 53
Installing mod_perl 1.0 in Three Steps......Page 54
Installing mod_perl on Unix Platforms......Page 55
Configuring and Starting the mod_perl Server......Page 58
Installing mod_perl for Windows......Page 60
Preparing the Scripts Directory......Page 63
A Sample Apache::Registry Script......Page 64
A Simple mod_perl Content Handler......Page 66
Is This All We Need to Know About mod_perl?......Page 69
References......Page 70
3. Installing mod_perl......Page 71
Configuring the Source......Page 72
Building mod_perl (make)......Page 87
Testing the Server (make test)......Page 88
Installation (make install)......Page 91
Installation Scenarios for Standalone mod_perl......Page 92
Building mod_perl with Other Components......Page 97
Installing mod_perl with the CPAN.pm Interactive Shell......Page 103
Installation into a Nonstandard Directory......Page 105
How Can I Tell if mod_perl Is Running?......Page 116
General Notes......Page 118
References......Page 120
Apache Configuration......Page 121
mod_perl Configuration......Page 130
The Startup File......Page 148
Apache Configuration in Perl......Page 152
Validating the Configuration Syntax......Page 166
The Scope of mod_perl Configuration Directives......Page 167
Apache Restarts Twice......Page 168
Tips and Tricks......Page 169
Configuration Security Concerns......Page 170
General Pitfalls......Page 173
References......Page 174
Starting the Server in Single-Process Mode......Page 175
Using kill to Control Processes......Page 176
Using apachectl to Control the Server......Page 182
Setuid root Startup Scripts......Page 183
Preparing for Machine Reboot......Page 186
Upgrading a Live Server......Page 191
Three-Tier Server Scheme: Development, Staging, and Production......Page 207
Web Server Monitoring......Page 215
Server Maintenance Chores......Page 228
References......Page 244
Before You Start to Code......Page 246
Exposing Apache::Registry Secrets......Page 248
Namespace Issues......Page 255
Perl Specifics in the mod_perl Environment......Page 263
CHECK and INIT Blocks......Page 271
Apache::Registry Specifics......Page 277
Transition from mod_cgi Scripts to Apache Handlers......Page 280
Loading and Reloading Modules......Page 288
Handling the \"User Pressed Stop Button\" Case......Page 307
Handling Server Timeout Cases and Working with $SIG{ALRM}......Page 319
Generating Correct HTTP Headers......Page 320
Method Handlers: The Browse and See, Browse and View Example......Page 324
References......Page 331
Part II. mod_perl Performance......Page 334
Looking at the Big Picture......Page 336
Asking the Right Questions......Page 338
References......Page 341
Choosing the Right Operating System......Page 342
Choosing the Right Hardware......Page 346
References......Page 351
9. Essential Tools for Performance Tuning......Page 352
Server Benchmarking......Page 353
Perl Code Benchmarking......Page 357
Process Memory Measurements......Page 362
Apache::Status and Measuring Code Memory Usage......Page 364
Code Profiling Techniques......Page 369
References......Page 376
Sharing Memory......Page 378
Forking and Executing Subprocesses from mod_perl......Page 400
References......Page 411
Setting the MaxClients Directive......Page 412
Setting the MaxRequestsPerChild Directive......Page 417
KeepAlive......Page 418
PerlSetupEnv......Page 419
Reducing the Number of stat( ) Calls Made by Apache......Page 420
Symbolic Links Lookup......Page 428
Disabling DNS Resolution......Page 429
Response Compressing......Page 430
References......Page 431
mod_perl Deployment Overview......Page 432
Standalone mod_perl-Enabled Apache Server......Page 434
One Plain and One mod_perl-Enabled Apache Server......Page 436
Adding a Proxy Server in httpd Accelerator Mode......Page 442
The Squid Server and mod_perl......Page 446
Apache\'s mod_proxy Module......Page 456
mod_rewrite Examples......Page 464
Getting the Remote Server IP in the Backend Server in the Proxy Setup......Page 466
Frontend/Backend Proxying with Virtual Hosts......Page 468
When One Machine Is Not Enough for Your RDBMS DataBase and mod_perl......Page 472
Running More than One mod_perl Server on the Same Machine......Page 477
SSL Functionality and a mod_perl Server......Page 479
Uploading and Downloading Big Files......Page 480
References......Page 481
Apache::Registry PerlHandler Versus Custom PerlHandler......Page 482
Apache::args Versus Apache::Request::param Versus CGI::param......Page 486
Buffered Printing and Better print( ) Techniques......Page 490
Interpolation, Concatenation, or List......Page 496
Keeping a Small Memory Footprint......Page 499
Object Methods Calls Versus Function Calls......Page 504
time( ) System Call Versus $r->request_time......Page 508
Caching and Pre-Caching......Page 509
Comparing Runtime Performance of Perl and C......Page 523
References......Page 536
Controlling Your Memory Usage......Page 537
Coding for a Smaller Memory Footprint......Page 541
Conclusion......Page 552
References......Page 553
Server Size as a Function of Compiled-in Features......Page 554
mod_status and ExtendedStatus On......Page 555
Perl Build Options......Page 556
References......Page 557
Date-Related Headers......Page 558
Content Headers......Page 561
HTTP Requests......Page 565
Avoiding Dealing with Headers......Page 568
References......Page 569
Part III. Databases and mod_perl......Page 570
Volatile Databases......Page 572
Non-Volatile Databases......Page 574
References......Page 578
Sharing the Read-Only Data in and Between Processes......Page 579
Sharing Data Between Various Handlers......Page 580
References......Page 583
19. DBM and mod_perl......Page 584
mod_perl and DBM......Page 586
Resource Locking......Page 587
Flawed Locking Methods......Page 590
Tie::DB_Lock......Page 592
Examples......Page 593
References......Page 598
20. Relational Databases and mod_perl......Page 599
Persistent Database Connections with Apache::DBI......Page 600
Improving Performance......Page 607
DBI Debug Techniques......Page 610
References......Page 611
Part IV. Debugging and Troubleshooting......Page 612
Warnings and Errors Explained......Page 614
Debugging Code in Single-Server Mode......Page 625
Tracing System Calls......Page 627
Tracing mod_perl-Specific Perl Calls......Page 628
Debugging Perl Code......Page 632
Analyzing Dumped core Files......Page 660
Hanging Processes: Detection and Diagnostics......Page 666
Useful Debug Modules......Page 675
Looking Inside the Server......Page 685
References......Page 690
Configuration and Startup......Page 691
Code Parsing and Compilation......Page 694
Runtime......Page 695
Shutdown and Restart......Page 699
23. Getting Help and Online Resources......Page 701
How to Report Problems......Page 702
Mailing List Etiquette......Page 704
Resources......Page 705
Part V. mod_perl 2.0......Page 712
24. mod_perl 2.0: Installation and Configuration......Page 714
What\'s New in Apache 2.0......Page 715
What\'s New in Perl 5.6.0-5.8.0......Page 718
What\'s New in mod_perl 2.0......Page 720
Installing mod_perl 2.0......Page 723
Configuring mod_perl 2.0......Page 726
Resources......Page 737
Migrating to and Programming with mod_perl 2.0......Page 738
New Apache Phases and Corresponding Perl*Handlers......Page 743
I/O Filtering......Page 757
Part VI. Appendixes......Page 780
Reusing Data from POST Requests......Page 782
Redirecting POST Requests......Page 783
Handling Cookies......Page 784
CGI::params in the mod_perlish Way......Page 785
mod_rewrite in Perl......Page 786
Setting PerlHandler Based on MIME Type......Page 788
Singleton Database Handles......Page 789
Terminating a Child Process on Request Completion......Page 791
References......Page 792
B. Apache Perl Modules......Page 793
Development-Stage Modules......Page 794
Modules to Aid Debugging......Page 797
Control and Monitoring Modules......Page 798
Server Configuration Modules......Page 799
Access-Phase Modules......Page 801
Trans Handlers......Page 802
Generic Content-Generation Modules......Page 804
Application-Specific Content-Generation Modules......Page 806
Database Modules......Page 809
Toolkits and Frameworks for Content-Generation and Other Phases......Page 810
Output Filters and Layering Modules......Page 813
Logging-Phase Handlers......Page 817
Core Apache Modules......Page 818
Other Miscellaneous Modules......Page 823
Users Sharing a Single Web Server......Page 829
Users Sharing a Single Machine......Page 830
Giving Each User a Separate Machine (Colocation)......Page 831
Giving Each User a Virtual Machine......Page 832
Fetching and Installing the Template Toolkit......Page 833
Typical Uses......Page 834
Template Toolkit Language......Page 836
Processing Templates......Page 839
Apache/mod_perl Handler......Page 842
Hangman Application......Page 844
References......Page 863
E. The AxKit XML Application Server......Page 864
Installing and Configuring AxKit......Page 865
Your First AxKit Page......Page 866
Dynamic Content......Page 868
More XPathScript Details......Page 875
XSLT......Page 877
Putting Everything Together......Page 881
More Reasons to Use AxKit......Page 884
HTTP/1.0 Status Codes......Page 885
HTTP/1.1 Status Codes......Page 886
References......Page 887
Index......Page 888