Python Tech

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

前言

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

安装

首先从 https://www.djangoproject.com/download/2.1.5/tarball/ 下载Django,解压并安装:

python -c "import urllib.request;urllib.request.urlretrieve ('https://www.djangoproject.com/download/2.1.5/tarball/', 'Django-2.1.5.tar.gz')"
tar xzvf Django-2.1.5.tar.gz
cd Django-2.1.5/
sudo python setup.py install

完成安装后,Django会拷贝`django-admin.py`到/usr/local/bin下,这个py文件引入了Django的管理模块。Django更常见的安装方式参看virtualenv, pipenv

创建项目

使用`startproject`命令创建一个Django项目,输入项目名称,例如`dmyz`:

django-admin startproject dmyz

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

dmyz/
|-- dmyz
|   |-- __init__.py
|   |-- settings.py
|   |-- urls.py
|   `-- wsgi.py
`-- manage.py

目录下与项目同名的应用里(本例中是dmyz)存放设置文件,所以下文的项目文件夹指的是`dmyz`,注意不要和`dmyz/dmyz`文件夹混淆。

  • manage.py:和django-admin相同,但会设置环境变量为当前项目的设置文件
  • dmyz/__init__.py:Python特性,可以是空文件,表明这个文件夹是一个可以导入的包
  • dmyz/settings.py:设置文件,本文主要修改数据库信息、模板目录、加载模块的信息
  • dmyz/urls.py:URL路由,指定函数与URL的映射关系
  • dmyz/wsgi.py:本文中不会使用,nginx/apache+wsgi在生产环境中运行Django时使用。

创建完成后,在项目文件夹执行`runserver`启动Django自带的开发服务器,如果修改文件,开发服务器会自动重启。启动时执行检查,如果正常则顺利启动:

python manage.py runserver

访问http://127.0.0.1:8000,如果顺利显示,说明Django开发服务器已经成功启动。但现在只有本机可以访问,要让外网能够访问,或是要更换默认的端口,可以增加参数:

$ python manage.py runserver 0.0.0.0:8080

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

数据库配置

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

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', #设置为mysql数据库
        'NAME': 'dmyz',  #mysql数据库名
        'USER': 'root',  #mysql用户名,留空则默认为当前linux用户名
        'PASSWORD': 'root',   #mysql密码
        'HOST': '',  #留空默认为localhost
        'PORT': '',  #留空默认为3306端口
    }
}

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

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

python -c "import urllib.request;urllib.request.urlretrieve ('https://github.com/PyMySQL/mysqlclient-python/archive/v1.4.1.tar.gz', 'mysqlclient-python-v1.4.1.tar.gz')"
tar xzvf mysqlclient-python-v1.4.1.tar.gz
cd mysqlclient-python-1.4.1/
sudo python setup.py install

可能会提示`EnvironmentError: mysql_config not found`。因为没有安装开发工具包,执行:

sudo apt-get install libmysqld-dev

执行`migrate`命令,把所有应用的迁移(Migrations)应用到数据库:

python manage.py migrate

如果相关的设置/包都正确,Django会创建下列表:

+----------------------------+
| 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             |
+----------------------------+

URL

现在首页还是默认内容。Django通过`urls.py`文件来匹配相应的视图。修改`dmyz/dmyz/urls.py`增加首页的路由:

from django.contrib import admin
from django.urls import path
from . import views  #引入views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.home),
]

`path`用来指定路由,`re_path`是正则形式的路由,等于之前版本的`url`。
在dmyz/dmyz/目录下新建`views.py`文件,内容如下:

from django.http import HttpResponse
def home(request):
    return HttpResponse('hello, world')

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

应用

这节编写一个名为`articles`的应用,从MySQL数据库里读取出文章作者、标题、内容。

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

python manage.py startapp articles

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

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

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

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    'articles', #加入应用
]

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

from django.db import models

# Create your models here.
class Article(models.Model):
    title = models.CharField(max_length=64)
    author = models.CharField(max_length=32)
    content = models.TextField()

    def __str__(self):
        return self.title

执行`makemigrations`,Django会根据模型文件自动生成迁移文件:

python manage.py makemigrations

应用迁移:

python manage.py migrate

MySQL数据库会创建名为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    |                |
+---------+-------------+------+-----+---------+----------------+

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

from django.shortcuts import render
from .models import Article #引入之前定义的model

def articles(request):
    article_list = Article.objects.order_by('-id')
    return render(request, 'articles.html', {'article_list': article_list})

编辑项目的urls.py文件(dmyz/dmyz/urls.py),导入articles的视图:

from django.conf.urls import include, url
from django.contrib import admin

from . import views
from articles import views as articles_views #导入articles的views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.home),
    path('articles/', articles_views.articles),
]

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

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

TEMPLATES = [
    {
         'BACKEND': 'django.template.backends.django.DjangoTemplates',
         'DIRS': [os.path.join(BASE_DIR, 'templates'),], #设置模版目录
         'APP_DIRS': True,
....

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

{% for article in article_list %}
Author:{{ article.author }}
Title:{{ article.title }}
Content:{{ article.title }}
{% endfor %}

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

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

自动化管理界面

自动化管理界面是Django最受欢迎的特征之一,现在的版本是默认开启的。首先创建一个超级用户:

python manage.py createsuperuser

输入账号、密码、邮箱。创建完成后访问:http://127.0.0.1:8000/admin/ ,使用刚才创建的账号登录。现在还看不到articles应用,编辑`articles/admin.py`:

from django.contrib import admin

from .models import Article # 导入文章模型

admin.site.register(Article) # 注册文章模型

刷新出现之前添加的应用。

后记

本文的一些设置并不适用于实际生产环境,旨在介绍一些入门知识和快速配置的方法,如果希望更规范的学习Django,首推Django的官方文档。

avatar

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据

  Subscribe  
最新 最旧 得票最多
提醒
logic
游客
logic

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

logic
游客
logic

问题已经解决,是我upload错了文件夹…

hahap
游客
hahap

url略虎……

zzzhhh
游客
zzzhhh

博主写个Django+mongodb的例子程序吧!

宁静致远
游客

应用是可以正常运行了,怪,但页面就是没有数据出现,但mysql中明明有数据.

Rockie
游客
Rockie

寫得很棒的文章,謝謝你的貢獻

查水表
游客
查水表

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

while(1)等;
游客
while(1)等;

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

卫军
游客

多谢解答 ,执行 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

卫军
游客

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

fc_lamp
游客

很好~~学习了

文章与网站一样,都很不错~

pp
游客
pp

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

trackback

[…] 建立django项目的方法可以点击这里。比如django项目文件夹是dmyz,放在dmyz-on-dotcloud目录中,现在要在dmyz-on-dotcloud下(即django项目文件夹的父文件夹)创建一个requirements.txt文件和wsgi.py文件: $ mkdir dmyz-on-dotcloud $ cd dmyz-on-dotcloud dmyz-on-dotcloud$ echo django > requirements.txt #wsgi.py import os import sys os.environ['DJANGO_SETTINGS_MODULE'] = 'dmyz.settings' #dmyz替换成你的项目名 import django.core.handlers.wsgi djangoapplication = django.core.handlers.wsgi.WSGIHandler() def application(environ, start_response): if 'SCRIPT_NAME' in environ: del environ['SCRIPT_NAME'] return djangoapplication(environ, start_response) […]

271145649
游客

又来看你了,一直觉得你网站做的挺不错的,嘿嘿,里面有不少内容可以转载。

游客
游客

从搜索引擎跑过来的,文章写的很不错。

liama1981
游客
liama1981

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

He.yang
游客
He.yang

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