Mention Catalyst::Plugin::Session in Catalyst::Manual::Plugins
[catagits/Catalyst-Runtime.git] / lib / Catalyst.pm
index f1f2ebe..49d8fc3 100644 (file)
@@ -749,6 +749,19 @@ Dispatch request to actions.
 
 sub dispatch { my $c = shift; $c->dispatcher->dispatch( $c, @_ ) }
 
+
+=item dump_these
+
+Returns a list of 2-element array references (name, structure) pairs that will
+be dumped on the error page in debug mode.
+
+=cut
+
+sub dump_these {
+    my $c = shift;
+    [ Request => $c->req ], [ Response => $c->res ], [ Stash => $c->stash ],;
+}
+
 =item $c->execute($class, $coderef)
 
 Execute a coderef in given class and catch exceptions.
@@ -1468,7 +1481,39 @@ sub setup_engine {
 qq/Couldn't load engine "$engine" (maybe you forgot to install it?), "$@"/
         );
     }
+    
+    # check for old engines that are no longer compatible
+    my $old_engine;
+    if (   $engine->isa('Catalyst::Engine::Apache')
+        && ! Catalyst::Engine::Apache->VERSION )
+    {
+        $old_engine = 1;
+    }
+    
+    elsif ( $engine->isa('Catalyst::Engine::Server::Base')
+         && Catalyst::Engine::Server->VERSION le '0.02' )
+    {
+        $old_engine = 1;
+    }
+    
+    elsif ( $engine->isa('Catalyst::Engine::HTTP::POE')
+         && $engine->VERSION eq '0.01' )
+    {
+        $old_engine = 1;
+    }
+    
+    elsif ( $engine->isa('Catalyst::Engine::Zeus')
+         && $engine->VERSION eq '0.01' )
+    {
+        $old_engine = 1;
+    }
 
+    if ($old_engine) {
+        Catalyst::Exception->throw( message =>
+            qq/Engine "$engine" is not supported by this version of Catalyst/
+        );
+    }
+            
     # engine instance
     $class->engine( $engine->new );
 }