时间:2021-07-01 10:21:17 帮助过:24人阅读
django-admin.py是Django的一个用于管理任务的命令行工具。本文将描述它的大概用法。
另外,在每一个Django project中都会有一个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中去找找看。
通常来说,如果你经常是在一个独立的Django project里工作,那么使用manage.py会更方便一些。但如果你有很多Django project,那么可以使用django-admin.py,同时需要经常变更DJANGO_SETTINGS_MODULE或使用–settings选项来设置不同的setting.py。
本文中都会使用django-admin.py来给大家做演示,但所有的例子,都也可以使用manage.py来实现。
【用法】
djang-admin.py的语法为:
django-admin.py[options] manage.py [options]
其中,subcommand是子命令;options是可选的,可以有0个到多个option。
获得帮助的方法是使用help这个命令,共有两种方法:
1 运行django-admin.py help会显示用法信息,并给出所有可用的subcommand列表
2 运行django-admin.py help
运行django-admin.py –version可以显示django的版本号。
如果使用django-admin.py时加入–verbosity,则会显示大量通知信息和调试信息。
【runfcgi】- subcommand
用于启动一个支持FastCGI协议的进程,以便接收WebServer发来的请求。可以使用flup作为Python FastCGI模块。
runfcgi的选项如下:
举例来说:
django-admin.py runfcgi socket=/tmp/fcgi.sock method=prefork daemonize=true \ pidfile=/var/run/django-fcgi.pid
此命令用于在后台启动fastCGI,并将pid写入文件中。
【runserver】- subcommand
用于在本机启动一个轻量级的Web server。默认情况下,这个server会在127.0.0.1上监听8000端口。你也可以传入参数来改变默认配置。
如果你并非特权用户,那么你所设置的端口号不能低于1024,因为小于1024的端口已经被系统预定了。
一定不要用这个轻量级Server作为你的生产环境下的Server,因为它只能用于开发自测阶段。它既没有安全审计功能,而且又是单线程的。
另外,每来一个请求,Web Server都会从新载入一遍Python代码,因此如果你的代码有改动,不需要重启Web Server即可生效。
你可以在一个project中启动多个fastcgi server,只要设置不同的端口就可以了。
如果你设定的IP为默认的127.0.0.1,那么你只能从本机的浏览器来登录浏览,无法从其他机器来访问。为了能让其他机器浏览本机,需要将IP设置为目标机器的IP或者0.0.0.0(IPv4地址)或::(IPv6地址)。
在指定IP地址时,也可以使用主机名或域名来代替。
【shell】- subcommand
用于开启一个Python解释器。
Django默认会使用IPython或bpython。但如果你没有安装它们或者就是要使用简装版的话,可以加上–plain选项,即:
django-admin.py shell --plain
【startapp】- subcommand
在当前路径或指定目录下创建一个Django app的文件夹结构。
默认情况下,文件夹中会包括module.py文件和其他必备文件。
如下命令用于在特定目录下创建一个app:
django-admin.py startapp myapp /Users/jezdez/Code/myapp
【startproject】- subcommand
In Django, Projects can have many apps. Apps can be shared among many projects.
在当前目录或指定位置创建一个Django project文件夹结构。
默认情况下,新文件夹中会包括manage.py和一系列必备文件。
目标位置参数是可选的参数,可以设置project所创建的路径。
例如,如下命令可以在指定位置创建一个project:
django-admin.py startproject myproject /Users/jezdez/Code/myproject_repo
和startapp命令一样,--template命令准许你指定一个文件夹,文件路径,或者一个自定义项目模板的链接,关于对项目模板的支持可以查看startapp的文档
下面的例子,在创建myproject项目的时候,会在指定的路径查找模板
django-admin.py startproject --template=/users/jezdez/code/my_project_template myproject
When Django copies the project template files, it also renders certain files through the template engine: the files whose extensions match the --extension option (py by default) and the files whose names are passed with the --name option. The template context used is:
Any option passed to the startproject command
project_name -- the project name as passed to the command
project_directory -- the full path of the newly created project
secret_key -- a random key for the SECRET_KEY setting
Please also see the rendering warning as mentioned for startapp.
syncdb
django-admin.py syncdb
这个命令将为以安装的(INSTALLED_APPS)apps创建数据表,如果数据表还没创建的话。
【扩展manage命令】
我们都用过Django的django-admin.py和manage.py。django-admin.py是一个命令行工具,可以执行一些管理任务,比如创建Django项目。而manage.py是在创建每个Django project时自动添加在项目目录下的,只是对manage.py的一个简单包装,其功能是将Django project放到sys.path目录中,同时设置DJANGO_SETTINGS_MODULE环境变量为当前project的setting.py文件。
django-admin.py调用django.core.management来执行命令:
#!/usr/bin/env python from django.core import management 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() def find_management_module(app_name): """ Determines the path to the management module for the given app_name, without actually importing the application or the management module. Raises ImportError if the management module cannot be found for any reason. """ parts = app_name.split('.') parts.append('management') parts.reverse() part = parts.pop() path = None
然后通过django.core.management.find_commands函数找到命令类。find_commands函数会在管理模块下查找.py文件,并将.py文件的名称匹配到命令名称:
def find_commands(management_dir): """ Given a path to a management directory, returns a list of all the command names that are available. Returns an empty list if no commands are defined. """ command_dir = os.path.join(management_dir, 'commands') try: return [f[:-3] for f in os.listdir(command_dir) if not f.startswith('_') and f.endswith('.py')] except OSError: return []
最后,通过django.core.management.load_command_class函数加载该.py文件中的Command类:
def load_command_class(app_name, name): """ Given a command name and an application name, returns the Command class instance. All errors raised by the import process (ImportError, AttributeError) are allowed to propagate. """ module = import_module('%s.management.commands.%s' % (app_name, name)) return module.Command()
在执行命令的时候,会执行相应Command类的handle方法。所有的Command类都应该是django.core.management.base.BaseCommand的直接或间接子类。
原理搞清楚了,扩展manage命令就很容易了。创建一个app并加入到settings的INSTALLED_APPS中,在该app下面创建management.commands模块,并创建hello.py文件:
from django.core.management.base import BaseCommand, CommandError from django.db import models #from placeholders import * import os class Command(BaseCommand): def handle(self, *args, **options): print 'hello, django!'
就可以使用hello命令了:
$ python manage.py hello hello, django!