Python Tech

Django+MySQL安装配置详解(Linux)[更新为1.8.2版]

Perface

Django是一个开源的Web应用框架,由Python写成,并于2005年7月在BSD许可证下发布。Django的主要目标是使得开发复杂的、数据库驱动的网站变得简单。Django采用MVC设计模式注重组件的重用性和“可插拔性”,敏捷开发和DRY法则(Don’t Repeat Yourself)。在Django中Python被普遍使用,甚至包括配置文件和数据模型。本文介绍Django在Linux(Ubuntu 14.04.2)+MySQL(5.5.43)环境下安装、配置的过程,包括安装、运行、添加应用的所有流程,最终建立一个可以从MySQL读取文章并显示的Django应用。文章面向刚接触Python/Django的初学者,所以安装过程都以默认环境为主,用pip可以简化安装过程。

Install

首先下载Django,得到Django-1.8.2.tar.gz,后解压并安装

$ wget https://www.djangoproject.com/m/releases/1.8/Django-1.8.2.tar.gz
$ tar xzvf Django-1.8.2.tar.gz
$ cd Django-1.8.2
$ sudo python setup.py install

如果提示缺少setuptools还要下载安装setuptools(建议提前安上,因为在安装MySQL for Python的时候也会用到)。

完成安装后,Django会拷贝django-admin.py到/usr/local/bin下,这个py文件引入了Django的管理模块。进阶安装方式可以参看virtualenv, pip

Setup

要创建一个Django项目非常简单,使用startproject命令,输入项目名称:

$ django-admin.py startproject mysite

Django会在当前目录下自动生成一个名为mysite的文件夹,里面有以下文件:

├── manage.py
└── mysite
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

以上是Django 1.4以后的目录结构(如果是1.4之前的版本,manage.py和settings.py等文件是在同一层)。站点的配置放在与项目同名的一个app里(本例中是mysite),所以下文的项目文件夹指的是mysite,注意不要和mysite/mysite文件夹混淆。

  • __init__.py:Python特性,可以是空文件,表明这个文件夹是一个可以导入的包。
  • settings.py:配置文件,本文主要修改数据库信息、模板目录、加载模块的信息。
  • url.py:URL配置文件,指定函数与URL的映射关系。
  • wsgi.py:本文中不会使用,nginx/apache+wsgi在生产环境中运行Django时使用。

创建完成后,在项目文件夹启动Django自带的web服务器。Django会自动检查配置文件中的错误,如果全部正常则顺利启动:

$ python manage.py runserver
Validating models…
Performing system checks…
System check identified no issues (0 silenced).
You have unapplied migrations; your app may not work properly until they are applied.
Run ‘python manage.py migrate’ to apply them.

June 01, 2015 – 00:00:00
Django version 1.8.2, using settings ‘mysite.settings’
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

访问http://127.0.0.1:8000,如果顺利显示,说明Django已经安装成功了。但现在只有本机可以访问,要让外网能够访问,或是要更换默认的8000端口,可以执行命令:

$ python manage.py runserver 0.0.0.0:8080

这样就将端口修改为8080,且外网也可以通过IP访问本机上的Django。

注意红字部分提示还没有执行migrate。这是1.7版本加入的数据库迁移工具,执行:

$ python manage.py migrate

可以看到Django创建了身份认证(auth)相关的表,默认是sqlite数据库,所以项目文件夹下会生成db.sqlite3这个文件。

现在要让Django支持MySQL数据库。编辑配置文件(mysite/mysite/settings.py)。找到DATABASES的配置,当前版本是在77行,默认是sqlite,把它改成MySQL:

代码的中文注释,在不指定Python文件编码的情况下会引起SyntaxError,所以不要复制这些中文注释。下文的中文注释同理。

Django(Python)操作MySQL依赖第三方包,所以要先安装MySQL for Python

$ wget https://pypi.python.org/packages/source/M/MySQL-python/MySQL-python-1.2.5.zip
$ unzip MySQL-python-1.2.5.zip
$ sudo python setup.py install

可能会提示EnvironmentError: mysql_config not found。因为没有安装开发工具包,所以找不到mysql_config文件,执行:

$ sudo apt-get install libmysqld-dev

安装模块后再次执行migrate命令,如果相关的模块/库都正确安装,Django会创建下列表:

mysql> show tables;
+—————————-+
| Tables_in_dmyz |
+—————————-+
| auth_group
| auth_group_permissions
| auth_permission
| auth_user
| auth_user_groups
| auth_user_user_permissions
| django_admin_log
| django_content_type
| django_migrations
| django_session
+—————————-+
10 rows in set (0.00 sec)

URL

现在首页还是默认内容。Django会通过URL配置文件来查找相应的对象,URL地址使用正则表达式设置。在mysite/mysite目录下可以找到urls.py文件,它是URL配置的默认起点,修改这个文件增加首页的配置:

在mysite/mysite文件夹下新建views.py文件,内容如下:

刷新网站首页,看到已经输出了”hello, world”。

Application

上一节”hello world”的例子只是说明了URL的用法,这节才是本文重点:编写一个名为articles的应用,从MySQL数据库里读取出文章作者、标题、内容。

首先建立应用,在项目文件夹中执行:

$ python manage.py startapp articles

运行后在项目文件夹中会创建article文件夹,包含下列文件:

articles/
├── admin.py
├── __init__.py
├── migrations
  └── __init__.py
├── models.py
├── tests.py
└── views.py
  • admin.py:当前应用在Django管理界面的设置。
  • migrations:数据库迁移用文件夹,创建的migrate会存在这个文件夹里。
  • models.py:模型文件,用 Python 类来描述数据表。
  • views.py:视图文件,用来联系模型与模版,主要的业务逻辑一般都写在这里。
  • tests.py:单元测试文件。

生成应用之后,要修改配置文件,告诉Django这个应用是属于当前项目的。打开配置文件(mysite/mysite/settings.py),找到INSTALLED_APPS元组,增加articles:

然后编写模型文件(article/models.py):

Django会根据模型文件自动生成migrations来操作数据库。syncdb命令在1.9版本之前仍然可以使用,但还是建议使用migrate:

$ python manage.py makemigrations
Migrations for ‘articles’:
  0001_initial.py:
    – Create model Article
$ python manage.py migrate
Running migrations:
  Rendering model states… DONE
    Applying articles.0001_initial… OK

Django会创建名为articles_article的表,包含一个默认的主键和之前定义的字段:

mysql> show columns from articles_article;
+———+————-+——+—–+———+—————-+
| Field | Type | Null | Key | Default | Extra |
+———+————-+——+—–+———+—————-+
| id | int(11) | NO | PRI | NULL | auto_increment |
| title | varchar(64) | NO | | NULL | |
| author | varchar(32) | NO | | NULL | |
| content | longtext | NO | | NULL | |
+———+————-+——+—–+———+—————-+
4 rows in set (0.00 sec)

简单的模型就设置完成了,现在编辑应用的视图(articles/views.py)文件:

编辑之前的urls.py文件(mysite/mysite/urls.py):

现在访问http://127.0.0.1:8000/articles/,直接运行会报错TemplateDoesNotExist at 路径,因为还没有告诉Django,到哪里去找articles.html文件。

编辑配置文件(mysite/mysite/settings.py),在56行找到TEMPLATE设置,在DIRS中设置一个模版路径,这里将模版目录指定为项目文件夹下的templates:

创建templates(mysite/templates)文件夹和articles.html文件(mysite/templates/articles.html)。如果使用过其它框架或者模板引擎,下面articles.html的内容就很容易看懂了,Django在模版文件中利用相应的TAG控制传递过来的变量显示的位置:

这样所有的配置就完成了,访问 http://127.0.0.1:8000/articles,Django会自动读取数据库中的内容,并显示在网页上。可以直接在数据库中写入数据,或是在Django的shell中操作:

$ python manage.py shell
>>> from articles.models import Article
>>> Article.create(title=’Django’, author=’perchouli’, content=’Django+MySQL’)

Epilogue

本文的一些设置并不适用于实际生产环境,旨在介绍一些入门知识和快速配置的方法,如果希望更规范的学习Django,首推Django的官方文档,其次是Djangobook,我更新这篇文章的时候Djangobook2.0中文版已经翻译了大半了,也是学习Django很好的教材。

26 thoughts on “Django+MySQL安装配置详解(Linux)[更新为1.8.2版]”

  1. 呵呵,官方教程没搞定,看这个倒是成功安装了,但没有管理工具的介绍哈。

    1. 因为开启、配置管理工具的步骤不是很复杂,无论是官方手册还是其他各种教程都有提到,所以就没有写了

  2. 运行syncdb命令的时候好像没有输入用户名,现在后台登录不了。请问怎么清空密码重设?

    1. 没有输入用户名的话默认会以当前系统的用户名来操作的。可以看一下数据库的auth_user

  3. 博主,你的文章有一处错误,{% for article in article_list %}要改成{% for article in list %}

    1. 是,这句写错了

      已经修改了,非常谢谢~

  4. 有两个疑问,1、项目文件夹都指mysite/mysite。python manage.py startapp article 这个命令是把manage.py拷贝到mysite/mysite文件夹 在这个目录下面执行的是不?2、INSTALLED_APPS元组 ‘article’, #加入app 这地方 是不是应该是‘mysite.article’ ,

    1. 多谢解答 ,执行 manage.py startapp blog 按照 文章描述的修改 INSTALLED_APPS元组为blog 运行 manage.py runserver访问 http://127.0.0.1:8000/blog/ 提示下面的错误, 我把生成的应用拷贝到mysite/mysite 下面这里我的mysite 是ops就(ops/ops)。 然后settings修改为ops.blog 就可以正常访问,有点搞不懂,是我用windows的原因?不知道你遇到过类似问题没有,多谢!ImportError at /blog/No module named blogRequest Method:GETRequest URL:http://127.0.0.1:8000/blog/Django Version:1.4.1Exception Type:ImportErrorException Value:No module named blog Exception Location:C:Python27libsite-packagesdjangoutilsimportlib.py in import_module, line 35Python Executable:C:Python27python.exePython Version:2.7.3Python Path:[‘F:\django\ops’, ‘C:\Windows\system32\python27.zip’, ‘C:\Python27\DLLs’, ‘C:\Python27\lib’, ‘C:\Python27\lib\plat-win’, ‘C:\Python27\lib\lib-tk’, ‘C:\Python27’, ‘C:\Python27\lib\site-packages’] Server time:Thu, 25 Oct 2012 10:54:07 +0800

    2. (r’^article/’, ‘mysite.article.views.latest_article’),在这里纠结了2天,最后在群里找人协助才知道应该为:(r’^article/’, ‘article.views.latest_article’),

    3. 博主我想问我需要安装mysql 或者mysql fof python 这些,还有你sudo apt-get install libmysqld-dev这句命令是安装了什么?本人是初学者所以这里不是很清楚

  5. 有两个疑问,1、项目文件夹都指mysite/mysite。python manage.py startapp article 这个命令是把manage.py拷贝到mysite/mysite文件夹 在这个目录下面执行的是不?2、INSTALLED_APPS元组 ‘article’, #加入app 这地方 是不是应该是‘mysite.article’ ,

    1. 1. manage.py是在mysite文件夹,而不是mysite/mysite文件夹,所以是在mysite下执行,不需要移动manage.py。2. 不用。mysite这个目录是用来组织django的,它本身不是一个model,mysite/mysite才是model,所以如果用mysite.article等于指向的是mysite/mysite/article了,位置不对。

      1. 多谢解答 ,执行 manage.py startapp blog 按照 文章描述的修改 INSTALLED_APPS元组为blog 运行 manage.py runserver访问 http://127.0.0.1:8000/blog/ 提示下面的错误, 我把生成的应用拷贝到mysite/mysite 下面这里我的mysite 是ops就(ops/ops)。 然后settings修改为ops.blog 就可以正常访问,有点搞不懂,是我用windows的原因?不知道你遇到过类似问题没有,多谢!ImportError at /blog/No module named blogRequest Method:GETRequest URL:http://127.0.0.1:8000/blog/Django Version:1.4.1Exception Type:ImportErrorException Value:No module named blog Exception Location:C:Python27libsite-packagesdjangoutilsimportlib.py in import_module, line 35Python Executable:C:Python27python.exePython Version:2.7.3Python Path:[‘F:\django\ops’, ‘C:\Windows\system32\python27.zip’, ‘C:\Python27\DLLs’, ‘C:\Python27\lib’, ‘C:\Python27\lib\plat-win’, ‘C:\Python27\lib\lib-tk’, ‘C:\Python27’, ‘C:\Python27\lib\site-packages’] Server time:Thu, 25 Oct 2012 10:54:07 +0800

  6. 博主,我mysql已经安装好,MySQL-python也装好了,setting配置文件中DATABASE也没有配置错误,也是配置成MySQL的了,但是我一migrate,还是立即生成了sqlite3文件,却不生成msyql表,为什么啊,郁闷死了,找不到原因啊。

Leave a Reply

Your email address will not be published. Required fields are marked *