connect-modrewrite
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/connect-modrewrite package

    0.10.2 • Public • Published

    connect-modrewrite Build Status

    NPM

    connect-modrewrite adds modrewrite functionality to connect/express server.

    Getting started

    Install connect-modrewrite with:

    npm install connect-modrewrite --save

    Require it:

    var modRewrite = require('connect-modrewrite');

    An example configuration:

    var app = connect() // express() for express 3.x  server
    // app.configure(function() { for express 3.x server
      .use(modRewrite([
        '^/test$ /index.html',
        '^/test/\\d*$ /index.html [L]',
        '^/test/\\d*/\\d*$ /flag.html [L]'
      ]))
      .use(connect.static(options.base))
      .listen(3000)
    // }) for express 3.x server

    Configurations

    In the example above, modRewrite take as an Array of rewrite rules as an argument. Each rewrite rule is a string with the syntax: MATCHING_PATHS REPLACE_WITH [FLAGS]. MATCHING_PATHS should be defined using a regex string. And that string is passed as an argument to the javascript RegExp Object for matching of paths. REPLACE_WITH is the replacement string for matching paths. Flags is optional and is defined using hard brackets.

    Inverted URL matching

    Begin with ! for inverted URL matching.

    Use defined params

    Just wrap the defined param with () and access it with $n. This is defined in JS .replace in https://developer.mozilla.org/en/docs/JavaScript/Reference/Global_Objects/String/replace.

    ^/blog/(.*) /$1

    Dash

    A dash indicates that no substitution should be performed.

    ^/blog/(.*) - [L]

    Flags

    Last [L]

    If a path matches, any subsequent rewrite rules will be disregarded.

    Proxy [P]

    Proxy your requests

    '^/test/proxy/(.*)$ http://nodejs.org/$1 [P]'

    Redirect [R], [R=3**] (replace * with numbers)

    Issue a redirect for request.

    Nocase [NC]

    Regex match will be case-insensitive.

    Forbidden [F]

    Gives a HTTP 403 forbidden response.

    Gone [G]

    Gives a HTTP 410 gone response.

    Type [T=*] (replace * with mime-type)

    Sets content-type to the specified one.

    Host [H], [H=*] (replace * with a regular expression that match a hostname)

    Match on host.

    For more info about available flags, please go to the Apache page: http://httpd.apache.org/docs/current/rewrite/flags.html

    Authors

    Tingan Ho, @tingan87

    License

    Licensed under the MIT license.

    Other recommended projects

    L10ns

    L10ns is an internationalization workflow and formatting tool. It handles complex localization problems like pluralization, genus based formatting etc. It also provides a workflow similar to XGettext.

    Keywords

    Install

    npm i connect-modrewrite

    DownloadsWeekly Downloads

    19,785

    Version

    0.10.2

    License

    none

    Last publish

    Collaborators

    • tinganho