Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lukechilds/htconvert

Convert .htaccess redirects to nginx.conf redirects
https://github.com/lukechilds/htconvert

apache cli nginx sysadmin

Last synced: about 1 month ago
JSON representation

Convert .htaccess redirects to nginx.conf redirects

Lists

README

        

# htconvert

> Convert .htaccess redirects to nginx.conf redirects.

[![Build Status](https://travis-ci.org/lukechilds/htconvert.svg?branch=master)](https://travis-ci.org/lukechilds/htconvert)
[![Coverage Status](https://coveralls.io/repos/github/lukechilds/htconvert/badge.svg?branch=master)](https://coveralls.io/github/lukechilds/htconvert?branch=master)
[![npm](https://img.shields.io/npm/dt/htconvert.svg)](https://www.npmjs.com/package/htconvert)
[![npm](https://img.shields.io/npm/v/htconvert.svg)](https://www.npmjs.com/package/htconvert)

## Install

```shell
npm install --global htconvert
```

## Usage

```shell
$ cat .htaccess | htconvert > nginxRedirects.conf
# or
$ htconvert -f .htaccess > nginxRedirects.conf
```

`.htaccess`

```apacheconf
# Frontend Redirects
Redirect 301 /deleted-page/ https://website.com/new-page/
Redirect 302 /new-feature/ https://website.com/coming-soon/

# Admin Redirects
Redirect 301 /admin/ https://website.com/?login=true
```

`nginxRedirects.conf`

```
# Frontend Redirects
location /deleted-page/ {
return 301 https://website.com/new-page/;
}
location /new-feature/ {
return 302 https://website.com/coming-soon/;
}

# Admin Redirects
location /admin/ {
return 301 https://website.com/?login=true;
}
```

### Options

```shell
$ htconvert --help

Usage: htconvert [options]

Options:

-h, --help output usage information
-V, --version output the version number
-f, --file [.htaccess] File containing .htaccess redirects
```

### Node

This is also usable as a node module

```shell
npm install --save htconvert
```

```js
var htconvert = require('htconvert');
var htaccess = 'Redirect 301 /deleted-page/ https://website.com/new-page/';

htconvert(htaccess);
// `location /deleted-page/ {
// return 301 https://website.com/new-page/;
// }`
```

## License

MIT © Luke Childs