Projekt

Obecné

Profil

Stáhnout (4.5 KB) Statistiky
| Větev: | Revize:
1
[![Express Logo](https://i.cloudup.com/zfY6lL7eFa-3000x3000.png)](http://expressjs.com/)
2

    
3
  Fast, unopinionated, minimalist web framework for [node](http://nodejs.org).
4

    
5
  [![NPM Version][npm-image]][npm-url]
6
  [![NPM Downloads][downloads-image]][downloads-url]
7
  [![Linux Build][travis-image]][travis-url]
8
  [![Windows Build][appveyor-image]][appveyor-url]
9
  [![Test Coverage][coveralls-image]][coveralls-url]
10

    
11
```js
12
const express = require('express')
13
const app = express()
14

    
15
app.get('/', function (req, res) {
16
  res.send('Hello World')
17
})
18

    
19
app.listen(3000)
20
```
21

    
22
## Installation
23

    
24
This is a [Node.js](https://nodejs.org/en/) module available through the
25
[npm registry](https://www.npmjs.com/).
26

    
27
Before installing, [download and install Node.js](https://nodejs.org/en/download/).
28
Node.js 0.10 or higher is required.
29

    
30
Installation is done using the
31
[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
32

    
33
```bash
34
$ npm install express
35
```
36

    
37
Follow [our installing guide](http://expressjs.com/en/starter/installing.html)
38
for more information.
39

    
40
## Features
41

    
42
  * Robust routing
43
  * Focus on high performance
44
  * Super-high test coverage
45
  * HTTP helpers (redirection, caching, etc)
46
  * View system supporting 14+ template engines
47
  * Content negotiation
48
  * Executable for generating applications quickly
49

    
50
## Docs & Community
51

    
52
  * [Website and Documentation](http://expressjs.com/) - [[website repo](https://github.com/expressjs/expressjs.com)]
53
  * [#express](https://webchat.freenode.net/?channels=express) on freenode IRC
54
  * [GitHub Organization](https://github.com/expressjs) for Official Middleware & Modules
55
  * Visit the [Wiki](https://github.com/expressjs/express/wiki)
56
  * [Google Group](https://groups.google.com/group/express-js) for discussion
57
  * [Gitter](https://gitter.im/expressjs/express) for support and discussion
58

    
59
**PROTIP** Be sure to read [Migrating from 3.x to 4.x](https://github.com/expressjs/express/wiki/Migrating-from-3.x-to-4.x) as well as [New features in 4.x](https://github.com/expressjs/express/wiki/New-features-in-4.x).
60

    
61
### Security Issues
62

    
63
If you discover a security vulnerability in Express, please see [Security Policies and Procedures](Security.md).
64

    
65
## Quick Start
66

    
67
  The quickest way to get started with express is to utilize the executable [`express(1)`](https://github.com/expressjs/generator) to generate an application as shown below:
68

    
69
  Install the executable. The executable's major version will match Express's:
70

    
71
```bash
72
$ npm install -g express-generator@4
73
```
74

    
75
  Create the app:
76

    
77
```bash
78
$ express /tmp/foo && cd /tmp/foo
79
```
80

    
81
  Install dependencies:
82

    
83
```bash
84
$ npm install
85
```
86

    
87
  Start the server:
88

    
89
```bash
90
$ npm start
91
```
92

    
93
  View the website at: http://localhost:3000
94

    
95
## Philosophy
96

    
97
  The Express philosophy is to provide small, robust tooling for HTTP servers, making
98
  it a great solution for single page applications, web sites, hybrids, or public
99
  HTTP APIs.
100

    
101
  Express does not force you to use any specific ORM or template engine. With support for over
102
  14 template engines via [Consolidate.js](https://github.com/tj/consolidate.js),
103
  you can quickly craft your perfect framework.
104

    
105
## Examples
106

    
107
  To view the examples, clone the Express repo and install the dependencies:
108

    
109
```bash
110
$ git clone git://github.com/expressjs/express.git --depth 1
111
$ cd express
112
$ npm install
113
```
114

    
115
  Then run whichever example you want:
116

    
117
```bash
118
$ node examples/content-negotiation
119
```
120

    
121
## Tests
122

    
123
  To run the test suite, first install the dependencies, then run `npm test`:
124

    
125
```bash
126
$ npm install
127
$ npm test
128
```
129

    
130
## Contributing
131

    
132
[Contributing Guide](Contributing.md)
133

    
134
## People
135

    
136
The original author of Express is [TJ Holowaychuk](https://github.com/tj)
137

    
138
The current lead maintainer is [Douglas Christopher Wilson](https://github.com/dougwilson)
139

    
140
[List of all contributors](https://github.com/expressjs/express/graphs/contributors)
141

    
142
## License
143

    
144
  [MIT](LICENSE)
145

    
146
[npm-image]: https://img.shields.io/npm/v/express.svg
147
[npm-url]: https://npmjs.org/package/express
148
[downloads-image]: https://img.shields.io/npm/dm/express.svg
149
[downloads-url]: https://npmjs.org/package/express
150
[travis-image]: https://img.shields.io/travis/expressjs/express/master.svg?label=linux
151
[travis-url]: https://travis-ci.org/expressjs/express
152
[appveyor-image]: https://img.shields.io/appveyor/ci/dougwilson/express/master.svg?label=windows
153
[appveyor-url]: https://ci.appveyor.com/project/dougwilson/express
154
[coveralls-image]: https://img.shields.io/coveralls/expressjs/express/master.svg
155
[coveralls-url]: https://coveralls.io/r/expressjs/express?branch=master
(3-3/5)