1 Star 11 Fork 0

天空蓝丶 / wekcms

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

wekcms内容管理系统!

系统简介

PHP开源CMS管理系统!

目录架构

├─wekcms 系统根目录
│  ├─app          		开发应用目录
│  │  ├─model      		数据表模型
│  │  ├─modules      	项目模块,核心开发目录
│  │  ├─stop      		拦截器存放目录
│  ├─cache        		系统文件缓存目录 
│  ├─configs      		配置文件目录
│  ├─functions    		自定义函数库目录
│  ├─install    		安装目录
│  ├─resources    		静态资源存放目录
│  ├─route        		路由规则目录
│  ├─templates    		模板存放目录
│  ├─vendor       		composer组件目录
│  ├─wekcms       		wekcms框架核心目录
│  |─classes      框架类库文件,自动加载
│  │  |─extend       扩展目录,初始化不自动加载
│  │  |─functions    框架函数文件,自动加载
│  │  |─tmp    		框架自用提示模板目录
│  │  ├─app       		框架初始化文件
│  ├─index.php    		入口文件目录

安装教程

  1. 使用gitee提供的方式下载
  2. 访问:域名/install 安装

开发文档:

开发注意事项:

  • wekcms支持php5.6~7.3 php7.4包括7.4以上暂不兼容
  • 模块的控制器名和方法名不能重复!
1:自定义路由

路由的规则定义在根目录的route目录下,框架初始化会加载route里所有的路由规则,路由规则建议一个模块是一个路由分组,不建议创建过多路由文件,有一点影响性能的事情都不要做!

路由文件的命名规则:文件名.route.php 路由文件必须以**.route.php**结尾才会被自动加载!

路由的定义:

//有效请求域名,为根域名
Route::get('/', function () {
    dd('访问首页显示的内容,这是一个get请求的闭包路由,post请求无效');
});

//有效请求域名为 根域名/post
Route::post('post', function () {
    dd('post请求才有效的闭包路由');
});

//有效请求域名为:根域名/all
Route::all('all', function () {
    dd('任何请求类型的都有效,get,post等');
});

//有效请求域名为:根域名/map
Route::map('map', function () {
    dd('任何请求类型的都有效,get,post等');
}, 'post,get');

//有效请求域名为:根域名/map
Route::map('map', function () {
    dd('只有post请求类型的有效');
}, 'post');

//分组路由,分组路由不支持分组嵌套,路由还能写中文哦
//参数一是用户请求的前缀   参数二是转发到控制器方法的公共前缀
Route::group('wek', 'app\content', function () {
    
    //有效请求域名为:根域名/wek/闭包
    Route::get('/闭包', function () {
        dd('闭包分组路由');
    });
    
    //有效请求域名为:根域名/wek/wek
    //转发的是:app(目录)/content(模块)/content(控制器)/wek(方法)
    //完整的是 app/content/content/wek  控制器和方法指建@隔开
    Route::get('/wek', '\content@wek');

});

2:路由参数

http://wekcms.cc/wek-1-2.html

以上url链接中,路由匹配的规则为 wek

路由的参数为wek后面的1和4,参数是以【-】隔开的,并且按照顺序1,2,3不包括.html后缀

获取路由参数:

    public function wek()
    {
        dd($_GET);
    }

打印的结果为:

Array
(
    [s] => /wek-1-4.html
    [tid] => 1
    [url_1] => 1
    [url_2] => 2
)

由此可见:

$_GET['url_1']的值为1

$_GET['url_2']的值为2

如果后面有更多的参数,依次类推,每个参数的值就是 url_参数的第几个的位数,从1计数,理论上,浏览器能写多少就能带多少

3:路由拦截器

拦截器使用非常简单,下面开始说明:

1:创建拦截器

项目根目的 app/stop 用于存放拦截器,拦截器文件命名规则是user.stop.php,以.stop.php后缀结尾,在user.stop.php中定义的方法就是拦截方法。

例如:创建一个用户类的拦截器

在app/stop创建了类文件 user.stop.php 定义了类方法auth,就创建了一个用户类拦截器。

app/stop/user.stop.php

<?php

class user
{
    //用户认证验证拦截
    public function auth()
    {
		//用于编写拦截器逻辑代码
    }
}

2:注册拦截器

注意:拦截器的使用必须搭配路由,否则无法使用

在路由注册闭包拦截器

<?php
//在路由上面定义一个闭包拦截器
Route::get('/', function () {
    dd('路由');
})->RouteStop(function () {
        dd('闭包路由拦截器');
});

在路由上注册定义好的auth 拦截器

->RouteStop('user.auth')就是注册拦截器,在定义路由的实体上注册拦截器要使用 RouteStop 方法。

<?php
Route::get('/', function () {
    dd('路由');
})->RouteStop('user.auth');

在路由上注册分组拦截器

->GroupStop('user.auth')就是注册分组的路由拦截器,在分组的实体上注册拦截器要使用 GroupStop 方法。

拦截器优先级:可以同时给路由分组和路由注册拦截器,路由的拦截器优先与分组的拦截器,就是说分组和路由都定义了拦截器,会先执行路由上注册的拦截器。

#分组路由,分组路由不支持分组嵌套
Route::group('wek', 'app\modules\content', function () {
    Route::get('/closure', function () {
        dd('闭包分组路由');
    })->RouteStop(function () {
        dd('闭包路由拦截器');
    });
//此处是路由分组的拦截器    
})->GroupStop('user.auth');

注册多个拦截器

路由和分组可以同时注册多个拦截器,但是闭包只能注册一个。

注册多个拦截器的写法就是,多个拦截器的执行顺序是从前往后,路由优先与分组。

//路由注册多拦截器,定义成数组
RouteStop(['user.auth','user.auth2','user.auth3']);

//路由分组注册多拦截器,定义成数组
GroupStop(['user.auth','user.auth2','user.auth3']);
4:伪静态规则

Ngix伪静态规则

在ngix配置的location中这样写,宝塔面板直接选择tp伪静态也是可以的

location / {
	if (!-e $request_filename){
		rewrite  ^(.*)$  /index.php?s=$1  last;   break;
	}
}

Apache伪静态规则

在根目录的index.php入口文件同级目录创建 .htaccess目录,并写入以下规则即可

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</IfModule>

开发计划

  • 完成wekcms步骤条安装功能

  • 完成模板引擎和缓存应用设计

  • app目录对模块,模型,细分化(修改路由组件)

  • 新增拦截器,并在路由注册拦截器

  • 内容模块的设计开发

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

PHP开源CMS管理系统! 展开 收起
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
PHP
1
https://gitee.com/wekyun/wekcms.git
git@gitee.com:wekyun/wekcms.git
wekyun
wekcms
wekcms
master

搜索帮助