详解Python的Django框架中manage命令的使用与扩展
【简介】
django-admin.py是Django的一个用于管理任务的命令行工具。本文将描述它的大概用法。
另外，在每一个Djangoproject中都会有一个manage.py。manage.py是对django-admin.py的简单包装，它额外帮助我们做了两件事情：
它将你的project的包放到sys.path中
它将DJANGO_SETTINGS_MODULE环境变量设置为了你的project的setting.py文件的位置。
如果你是通过setup.py工具来安装Django的，那么django-admin.py脚本应该在你的系统目录中。如果不存在，你可以到你的python安装目录下的site-package/django/bin中去找找看。
通常来说，如果你经常是在一个独立的Djangoproject里工作，那么使用manage.py会更方便一些。但如果你有很多Djangoproject，那么可以使用django-admin.py，同时需要经常变更DJANGO_SETTINGS_MODULE或使用–settings选项来设置不同的setting.py。
本文中都会使用django-admin.py来给大家做演示，但所有的例子，都也可以使用manage.py来实现。
【用法】
djang-admin.py的语法为：
django-admin.py<subcommand>[options] manage.py<subcommand>[options]
其中，subcommand是子命令；options是可选的，可以有0个到多个option。
获得帮助的方法是使用help这个命令，共有两种方法：
1运行django-admin.pyhelp会显示用法信息，并给出所有可用的subcommand列表
2运行django-admin.pyhelp<subcommand>会显示特定的subcommand的描述信息，以及所有可用的options
运行django-admin.py–version可以显示django的版本号。
如果使用django-admin.py时加入–verbosity，则会显示大量通知信息和调试信息。
【runfcgi】-subcommand
用于启动一个支持FastCGI协议的进程，以便接收WebServer发来的请求。可以使用flup作为PythonFastCGI模块。
runfcgi的选项如下：
- protocol：用于设定所使用的cgi协议，包括fcgi、scgi和ajp等，默认是fcgi。
- host：用于设置监听所在的主机名
- port：用于设定监听的端口
- socket：用于设置监听的UNIXsocket
- method：可以设置为prefork或threaded。默认是prefork。
- maxrequests：一个子进程所能处理的请求的最大数量。一旦超过此数量，则子进程会被kill掉，并创建一个新进程。设置为0意味着对子进程无限制。
- maxspare：空闲进程/线程的最大数量
- minspare：空闲进程/线程的最小数量
- maxchildren：进程/线程数的硬限制值
- daemonize：为boolean值，表示是否放到后台运行。
- pidfile：设置一个文件，用于将产生的PID信息写入。
- workdir：用于设置工作目录
- debug：为boolean值，用于设置是否开启flup的信息跟踪
- outlog：用于设置将标准输出写入到的文件
- errlog：用于设置将标准错误输出写入到的文件
- umask：用于设置在进程运行时所用的umask。默认是022.
举例来说：
django-admin.pyrunfcgisocket=/tmp/fcgi.sockmethod=preforkdaemonize=true\ pidfile=/var/run/django-fcgi.pid
此命令用于在后台启动fastCGI，并将pid写入文件中。
【runserver】-subcommand
用于在本机启动一个轻量级的Webserver。默认情况下，这个server会在127.0.0.1上监听8000端口。你也可以传入参数来改变默认配置。
如果你并非特权用户，那么你所设置的端口号不能低于1024，因为小于1024的端口已经被系统预定了。
一定不要用这个轻量级Server作为你的生产环境下的Server，因为它只能用于开发自测阶段。它既没有安全审计功能，而且又是单线程的。
另外，每来一个请求，WebServer都会从新载入一遍Python代码，因此如果你的代码有改动，不需要重启WebServer即可生效。
你可以在一个project中启动多个fastcgiserver，只要设置不同的端口就可以了。
如果你设定的IP为默认的127.0.0.1，那么你只能从本机的浏览器来登录浏览，无法从其他机器来访问。为了能让其他机器浏览本机，需要将IP设置为目标机器的IP或者0.0.0.0（IPv4地址）或::(IPv6地址)。
在指定IP地址时，也可以使用主机名或域名来代替。
【shell】-subcommand
用于开启一个Python解释器。
Django默认会使用IPython或bpython。但如果你没有安装它们或者就是要使用简装版的话，可以加上–plain选项，即：
django-admin.pyshell--plain
【startapp】-subcommand
在当前路径或指定目录下创建一个Djangoapp的文件夹结构。
默认情况下，文件夹中会包括module.py文件和其他必备文件。
如下命令用于在特定目录下创建一个app：
django-admin.pystartappmyapp/Users/jezdez/Code/myapp
【startproject】-subcommand
InDjango,Projectscanhavemanyapps.Appscanbesharedamongmanyprojects.
在当前目录或指定位置创建一个Djangoproject文件夹结构。
默认情况下，新文件夹中会包括manage.py和一系列必备文件。
目标位置参数是可选的参数，可以设置project所创建的路径。
例如，如下命令可以在指定位置创建一个project：
django-admin.pystartprojectmyproject/Users/jezdez/Code/myproject_repo
和startapp命令一样，--template命令准许你指定一个文件夹，文件路径，或者一个自定义项目模板的链接，关于对项目模板的支持可以查看startapp的文档
下面的例子，在创建myproject项目的时候，会在指定的路径查找模板
django-admin.pystartproject--template=/users/jezdez/code/my_project_templatemyproject
WhenDjangocopiestheprojecttemplatefiles,italsorenderscertainfilesthroughthetemplateengine:thefileswhoseextensionsmatchthe--extensionoption(pybydefault)andthefileswhosenamesarepassedwiththe--nameoption.Thetemplatecontextusedis:
Anyoptionpassedtothestartprojectcommand
project_name--theprojectnameaspassedtothecommand
project_directory--thefullpathofthenewlycreatedproject
secret_key--arandomkeyfortheSECRET_KEYsetting
Pleasealsoseetherenderingwarningasmentionedforstartapp.
syncdb
django-admin.pysyncdb
这个命令将为以安装的（INSTALLED_APPS）apps创建数据表，如果数据表还没创建的话。
【扩展manage命令】
我们都用过Django的django-admin.py和manage.py。django-admin.py是一个命令行工具，可以执行一些管理任务，比如创建Django项目。而manage.py是在创建每个Djangoproject时自动添加在项目目录下的，只是对manage.py的一个简单包装，其功能是将Djangoproject放到sys.path目录中，同时设置DJANGO_SETTINGS_MODULE环境变量为当前project的setting.py文件。
django-admin.py调用django.core.management来执行命令:
#!/usr/bin/envpython fromdjango.coreimportmanagement if__name__=="__main__": management.execute_from_command_line()
excute_from_command_line()函数会根据命令行参数解析出命令的名称，根据命令名称调用相应的Command执行命令。Command位于各个管理模块的commands模块下面。
所谓管理模块，是指在app模块下的名字为management的模块。Django通过django.core.management.find_management_module函数发现"管理模块":
django.core.management.find_management_module()
deffind_management_module(app_name):
"""
Determinesthepathtothemanagementmoduleforthegivenapp_name,
withoutactuallyimportingtheapplicationorthemanagementmodule.
RaisesImportErrorifthemanagementmodulecannotbefoundforanyreason.
"""
parts=app_name.split('.')
parts.append('management')
parts.reverse()
part=parts.pop()
path=None
然后通过django.core.management.find_commands函数找到命令类。find_commands函数会在管理模块下查找.py文件，并将.py文件的名称匹配到命令名称:
deffind_commands(management_dir):
"""
Givenapathtoamanagementdirectory,returnsalistofallthecommand
namesthatareavailable.
Returnsanemptylistifnocommandsaredefined.
"""
command_dir=os.path.join(management_dir,'commands')
try:
return[f[:-3]forfinos.listdir(command_dir)
ifnotf.startswith('_')andf.endswith('.py')]
exceptOSError:
return[]
最后，通过django.core.management.load_command_class函数加载该.py文件中的Command类:
defload_command_class(app_name,name):
"""
Givenacommandnameandanapplicationname,returnstheCommand
classinstance.Allerrorsraisedbytheimportprocess
(ImportError,AttributeError)areallowedtopropagate.
"""
module=import_module('%s.management.commands.%s'%(app_name,name))
returnmodule.Command()
在执行命令的时候，会执行相应Command类的handle方法。所有的Command类都应该是django.core.management.base.BaseCommand的直接或间接子类。
原理搞清楚了，扩展manage命令就很容易了。创建一个app并加入到settings的INSTALLED_APPS中，在该app下面创建management.commands模块，并创建hello.py文件:
fromdjango.core.management.baseimportBaseCommand,CommandError fromdjango.dbimportmodels #fromplaceholdersimport* importos classCommand(BaseCommand): defhandle(self,*args,**options): print'hello,django!'
就可以使用hello命令了:
$pythonmanage.pyhello hello,django!