python django+uwsgi+nginx 搭建步骤（血一般的教训）

安装Django

 

   没有pip的童鞋可以看 http://blog.csdn.net/imphp/article/details/38228619安装python包管理工具pip

   先在   https://pypi.python.org/ 上 搜索Django,排在第一的那个就是我们要安装的主要框架Django啦～

   点进去可以查找一些相关文档，虽然全部是鸟语花香，不过有翻译.百度.炕忙，就算是菜鸟也成英国鸟了。

Django 的官网文档  https://docs.djangoproject.com/en/dev/

@.@ 找了一会，发现没什么有用的～在官网down频道发现一个起码算是有用的命令:

    # pip install Django==1.6.5  // 获取官方最后更新的版本

    #  python -c  "import django; print(django.get_version())" // 如果Django已经安装，则会显示安装的版本，否则会提示 No module named django

创建一个Django项目

    Django的项目 不想 php的项目，一般php的项目会将所有的代码放到服务器上（/wwwroot/xx.php）这样运行，但实际上这样的方法不太安全，也更容易被别人看到代码。

    Django的项目代码可以放在任何目录下，如 /home/dj

    个人学习阶段放在了 /data/project/下

    # cd /data/project

    # django-admin.py help 可以看到django的一些常用操作方式

    # django-admin.py startproject dj 创建一个名为 dj 的项目

    # tree dj

1. dj
2. ├── dj
3. │   ├── __init__.py
4. │   ├── settings.py
5. │   ├── urls.py
6. │   └── wsgi.py
7. └── manage.py

    外层的 dj 只是一个包含项目的 名称， 可以将该目录名修改

    内层的 dj 目录里面 有一个空的__init__.py ，这是python的写法，告诉python这是一个将被引用的包

    manage.py 是项目管理的主要方法 

    #  dj/manage.py help 可以看到好多方法

    

    下面是 django官网关于django-admin.py & manage.py 的命令方法介绍：

         https://docs.djangoproject.com/en/1.6/ref/django-admin/

    

运行一个Django项目

    

    简单的运行方式为：

    ＃　 python manage.py runserver

     ...漫长的等待过后

1. Validating models...
3. 0 errors found
4. July 28, 2014 - 14:18:04
5. Django version 1.6.5, using settings 'dj.settings'
6. Starting development server at http://127.0.0.1:8000/
7. Quit the server with CONTROL-C.

    如果你想将端口号修改，或者ip修改，可以执行:

    #   python manage.py runserver 8080 / 0.0.0.0:8000

    访问上述地址，就会看到  Welcome to Django 页面了。

    这只是使用Django自带的webserver，下面我们要通过uwsgi将nginx与django组合到一起。

通过uwsgi将Nginx与Django组合一起

   

    官方文档： http://uwsgi-docs.readthedocs.org/en/latest/WSGIquickstart.html#installing-uwsgi-with-python-support

     先安装uwsgi

        # pip install uwsgi

        ...漫长的等待过后

        发现一个大大的track

1. Traceback (most recent call last):
2. File "/bin/pip", line 11, in <module>
3. sys.exit(main())
4. File "/usr/lib/python2.7/site-packages/pip/__init__.py", line 185, in main
5. return command.main(cmd_args)
6. File "/usr/lib/python2.7/site-packages/pip/basecommand.py", line 161, in main
7. text = '\n'.join(complete_log)
8. UnicodeDecodeError: 'ascii' codec can't decode byte 0xe8 in position 40: ordinal not in range(128)

     多番查找后，发现解决问题的办法：

         # 在 python的Lib\site-packages文件夹下新建一个sitecustomize.py，代码为

1. # encoding=utf8
2. import sys
4. reload(sys)
5. sys.setdefaultencoding("utf8")

       # 此方法为，python启动的时候，会自动调用该文件，这样就不再需要每次都手动设置编码了

        # pip install uwsgi 重新安装试试看～

        # 我靠，还是报错～算了，直接用源码安装吧

1. wget http://projects.unbit.it/downloads/uwsgi-latest.tar.gz
2. tar zxvf uwsgi-latest.tar.gz
3. cd <dir>
4. make

          ...漫长的等待过后

         # 又出现了一个这样的错误

1. [gcc -pthread] plugins/python/python_plugin.o
2. In file included from plugins/python/python_plugin.c:1:0:
3. plugins/python/uwsgi_python.h:2:20: 致命错误：Python.h：没有那个文件或目录
4. #include <Python.h>

         # 一般出现这种问题，都是 xx-devel没有安装，那我们就试一下看看有没有 python-devel

         #  yum install python-devel

         # 竟发现还真有～

         # 这样的话，那之前 pip install uwsgi 会不会因为这个原因导致失败的呢～

         # pip install uwsgi

          ...漫长的等待过后

         # 终于成功了！看来一切罪魁祸首，就是 python-devel了！

1. total build time: 178 seconds
2. *** uWSGI is ready, launch it with /usr/bin/uwsgi ***
4. Successfully installed uwsgi
5. Cleaning up...

         # 小小的试验一下

        # uwsgi --help  // 一堆命令参数，还是看文档吧

         # 配置nginx

1. location / {
2. include uwsgi_params;
3. uwsgi_pass 127.0.0.1:9000;
4. }

         # uwsgi 调用参数

         # 根据官网的说明：

         # 假设你的django项目目录在 /data/project下

1. uwsgi --socket 127.0.0.1:9000 --chdir /data/project/dj/ --wsgi-file dj/wsgi.py --master --processes 2 --threads 2

         # ok！ 再次访问nginx配置的页面，发现是不是看到了django的欢迎界面！

         # 再次验证了一点，python的项目不需要放在 wwwroot类似的目录中，可以放在任意目录下！

         # 每次这么写是不是很麻烦～uwsgi提供用配置文件的方式执行：

         # 创建一个 dj.ini文件

1. [uwsgi]
2. daemonize = 127.0.0.1:4000
3. socket = 127.0.0.1:9000
4. chdir = /data/project/dj/
5. wsgi-file = dj/wsgi.py
6. master = true
7. processes = 2
8. threads = 2
9. stats = 172.16.11.121:9191

         # uwsgi dj.ini 同样可实现上面的功能。

          # 详细参数 可以参考 ： http://www.cnblogs.com/zhouej/archive/2012/03/25/2379646.html

         # 到此，你的django就可以通过uwsgi在nginx下运行了！

        开始学习django吧！