簡介信呼協(xié)同辦公OA系統(tǒng) v1.8.6 是一套面向企業(yè)的開源協(xié)同辦公解決方案旨在打通跨平臺、多終端的工作流程覆蓋任務(wù)管理、日程安排、審批流轉(zhuǎn)、即時(shí)通訊、文件共享與人事考勤等典型場景適合需要快速搭建辦公系統(tǒng)的中小型團(tuán)隊(duì)也適合PHP開發(fā)人員學(xué)習(xí)二次開發(fā)。壓縮包共包含1248個(gè)文件以597個(gè)PHP源碼文件為核心配合前端JS、CSS、HTML及圖片、字體等靜態(tài)資源整體僅2.79MB輕量易部署。系統(tǒng)特別強(qiáng)化了Android/iOS移動端適配支持出差途中完成審批與任務(wù)處理同時(shí)提供權(quán)限管理和數(shù)據(jù)加密機(jī)制滿足企業(yè)敏感信息保護(hù)需求。目前已有316人瀏覽學(xué)習(xí)對于關(guān)注開源OA或希望低成本實(shí)現(xiàn)信息化管理的使用者這份源碼包可直接用于本地部署、功能定制與代碼研讀。 做企業(yè)信息化這些年被問得最多的一個(gè)問題不是“要不要上OA”而是“上什么OA”。尤其對十到上百人的中小企業(yè)來說預(yù)算有限、IT人手又少動輒幾萬塊實(shí)施費(fèi)的商業(yè)化OA往往第一輪就嚇退了人。信呼協(xié)同辦公OA系統(tǒng) v1.8.6 這種開源PHP OA正好是另一個(gè)選擇。它把審批、考勤、匯報(bào)、任務(wù)、公告這類高頻辦公場景做成了開箱即用的模塊愿意折騰的話還支持二次開發(fā)。我把它推薦給三類人一是想低成本把線上審批跑起來的中小企業(yè)管理者二是公司里有Linux/PHP基礎(chǔ)、想自己運(yùn)維OA的信息化專員三是想研究企業(yè)辦公系統(tǒng)怎么設(shè)計(jì)的開發(fā)者。先給沒接觸過的朋友一個(gè)畫像信呼OA是一套基于PHP和MySQL構(gòu)建的開源協(xié)同辦公系統(tǒng)源碼可以下載到自己服務(wù)器上部署。它把行政辦公里最常碰到的幾件麻煩事統(tǒng)一收進(jìn)了瀏覽器和手機(jī)端請假審批、報(bào)銷審批、用章申請、考勤打卡、公告通知、任務(wù)分派、客戶管理、資產(chǎn)管理等。v1.8.6 是其中一個(gè)穩(wěn)定的迭代版本功能覆蓋已經(jīng)比較完整適合作為私有化部署的起點(diǎn)。1. 信呼OA v1.8.6 到底是什么1.1 為什么選開源OA而不直接買商業(yè)產(chǎn)品有些人一聽到開源就覺得是簡陋的代名詞其實(shí)不能一刀切。商業(yè)OA賣的是實(shí)施、服務(wù)、接口和合規(guī)承諾適合預(yù)算充足、流程復(fù)雜、IT精細(xì)化管理的大型組織。而中小企業(yè)更需要的往往只是把紙質(zhì)報(bào)銷、微信群里報(bào)事這種混亂狀態(tài)轉(zhuǎn)成有跡可循的線上流程。信呼這類開源OA能把這塊做得很扎實(shí)而且省下來的授權(quán)費(fèi)可以請人做定制開發(fā)。當(dāng)然開源也有代價(jià)沒有廠商提供7x24小時(shí)服務(wù)出了問題得自己看日志需求得自己改。所以我建議在正式選擇前先問自己三個(gè)問題公司是否有人能處理基礎(chǔ)的Linux和PHP問題流程是否優(yōu)先做標(biāo)準(zhǔn)化而不是一開始就追求復(fù)雜條件分支是否接受用社區(qū)文檔和搜索引擎解決問題三條都滿足開源OA的性價(jià)比會非常明顯。1.2 技術(shù)棧與 v1.8.6 的版本特點(diǎn)從技術(shù)上拆開看信呼的核心是PHPMySQL服務(wù)端運(yùn)行在Nginx/Apache環(huán)境下前端是瀏覽器頁面另外適配了企業(yè)微信、釘釘?shù)纫苿愚k公入口。這里要注意的是PHP版本兼容性v1.8.6 時(shí)代的代碼更習(xí)慣于PHP 7.x直接上PHP 8.x 可能會遇到老函數(shù)被移除、擴(kuò)展不兼容的問題。我個(gè)人的建議是部署環(huán)境優(yōu)先選PHP 7.0到7.4之間的版本MySQL 5.6或5.7穩(wěn)定優(yōu)先。v1.8.6 這個(gè)版本從我的使用感受來說重點(diǎn)改進(jìn)在流程流轉(zhuǎn)的穩(wěn)定性和表單字段的靈活性上。比如審批節(jié)點(diǎn)里支持轉(zhuǎn)辦、加簽、同意、駁回表單數(shù)據(jù)可以按部門、按角色做數(shù)據(jù)權(quán)限隔離。這些能力已經(jīng)能覆蓋絕大多數(shù)中小企業(yè)的日常需求。模塊設(shè)計(jì)上采用按需啟用的方式不需要的功能可以關(guān)閉避免菜單鋪滿屏、員工不知道怎么點(diǎn)。2. 部署環(huán)境與安裝實(shí)操信呼的部署并不復(fù)雜但很多初次接觸的人會栽在環(huán)境細(xì)節(jié)上。我在幫朋友部署時(shí)見過太多“明明按文檔裝為什么白屏”的情況最后查出來都是PHP版本不對或目錄權(quán)限沒放開。先把環(huán)境準(zhǔn)備好后面就順暢了。2.1 環(huán)境準(zhǔn)備與參數(shù)選擇環(huán)境項(xiàng)推薦配置說明Web服務(wù)器Nginx 1.16 或 Apache 2.4Nginx需要配置偽靜態(tài)Apache默認(rèn)兼容較好PHP7.0 ~ 7.4不推薦PHP 8.x老代碼兼容性有風(fēng)險(xiǎn)PHP擴(kuò)展PDO、pdo_mysql、curl、gd、mbstring、fileinfo影響數(shù)據(jù)庫連接、圖片處理和文件上傳數(shù)據(jù)庫MySQL 5.6/5.7 或 MariaDB安裝前確認(rèn)字符集支持操作系統(tǒng)CentOS 7 / Ubuntu 18.04 / Debian 10均可有面板管理工具更省事表里的每一項(xiàng)都有原因。PHP 7.x 是性能與兼容性的平衡點(diǎn)pdo_mysql 是框架訪問數(shù)據(jù)庫的基礎(chǔ)gd 庫影響驗(yàn)證碼和圖片縮略圖fileinfo 會影響文件上傳的類型識別。缺任何一個(gè)擴(kuò)展安裝向?qū)Э赡茏叩揭话刖蛨?bào)錯(cuò)。所以裝完P(guān)HP后先用php -m看一眼擴(kuò)展列表會比后面排查錯(cuò)誤省事得多。2.2 三步完成安裝第一步把源碼包上傳到Web目錄并解壓。比如放在 /var/www/html/xinhu 下接下來設(shè)置目錄權(quán)限cd /var/www/html unzip xinhu_v1.8.6.zip -d xinhu cd xinhu chown -R www:www * chmod -R 755 upload runtime這里先把數(shù)據(jù)上傳目錄和緩存目錄放開權(quán)限否則安裝時(shí)生成文件會失敗。具體目錄名以你拿到的包為準(zhǔn)比如有些版本叫 upload有些叫 attachment 或 data。如果不清楚可以直接查源碼包里的安裝說明。第二步創(chuàng)建數(shù)據(jù)庫。用phpMyAdmin或命令行創(chuàng)建注意字符集選 utf8 或 utf8mb4CREATE DATABASE xinhu DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;第三步瀏覽器訪問http://你的服務(wù)器地址/install.php或/install/按頁面提示填寫數(shù)據(jù)庫名、數(shù)據(jù)庫賬號、管理員賬號密碼。填寫時(shí)切忌把數(shù)據(jù)庫賬號寫成 root除非你的服務(wù)器只在內(nèi)網(wǎng)否則風(fēng)險(xiǎn)太高。安裝完成后官方慣例是刪除或重命名 install 相關(guān)文件防止被人重裝覆蓋。整個(gè)過程不復(fù)雜真正花時(shí)間的反而是后面把 Nginx 的重寫規(guī)則配好。如果用的是 Apache.htaccess 一般自帶如果用的是 Nginx需要在 server 塊里加一段類似下面的配置location / { try_files $uri $uri/ /index.php?s$uri$args; } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }這一段是讓 URL 去掉 index.php 也能訪問。信呼一部分入口在 index.php 后面帶參數(shù)一部分路由是 PATH_INFO 模式偽靜態(tài)規(guī)則不對最常見的表現(xiàn)就是登錄后點(diǎn)菜單一片空白。2.3 部署后的安全收斂安裝完成只是開始有三件事我建議立刻做。第一把 install 目錄刪掉或改名防止有人再次執(zhí)行安裝覆蓋你的系統(tǒng)第二后臺把默認(rèn)的管理員用戶名改掉密碼設(shè)成足夠長的隨機(jī)字符串不要用 admin/admin 這類組合第三如果有公網(wǎng)地址一定要配 HTTPS用免費(fèi)證書就能搞定。OA系統(tǒng)里流轉(zhuǎn)的是報(bào)銷單、合同、人事信息沒有 HTTPS 等于在辦公室門口貼了一張員工薪資表。另外數(shù)據(jù)庫賬號盡量單獨(dú)建一個(gè)只授權(quán)信呼需要的庫權(quán)限給 SELECT、INSERT、UPDATE、DELETE、ALTER、CREATE 就夠了。這樣即使 PHP 代碼出了問題數(shù)據(jù)庫被拖庫的風(fēng)險(xiǎn)也小一些。3. 核心功能與典型業(yè)務(wù)配置系統(tǒng)裝好以后最容易迷惑的就是功能太多從哪下手。我一般建議按“審批流程優(yōu)先、考勤基礎(chǔ)配置次之、其他模塊按需開”的順序來。先讓員工每天真正用到系統(tǒng)才算上線。3.1 審批流程怎么配才靈活審批是OA的核心也是使用頻率最高的功能。信呼的流程設(shè)計(jì)思路是“表單節(jié)點(diǎn)”先定義一張審批表單比如費(fèi)用報(bào)銷單包含申請人、費(fèi)用類型、金額、事由、附件等字段再定義這條審批要經(jīng)過哪些節(jié)點(diǎn)比如發(fā)起人提交、部門負(fù)責(zé)人審批、財(cái)務(wù)復(fù)核、歸檔。每個(gè)節(jié)點(diǎn)都可以設(shè)置誰能處理、能否轉(zhuǎn)辦、能否加簽、超時(shí)怎么辦。我在配置時(shí)最常用的一個(gè)小技巧是把第一個(gè)節(jié)點(diǎn)設(shè)置為“發(fā)起人所在部門負(fù)責(zé)人”而不是寫死某一個(gè)具體的人。用角色和崗位關(guān)聯(lián)來指定審批人員工調(diào)崗或離職后流程不會因?yàn)椤罢也坏綇埲倍ㄗ?。這個(gè)思路很多人在搜“泛微OA如何新建配置流程”時(shí)也會看到類似做法但在信呼里就是角色/部門節(jié)點(diǎn)審批人的組合邏輯更直觀。配置完一定要走一遍測試單。我見過太多單位上線第一天發(fā)現(xiàn)流程到第二個(gè)人那里就不動了原因往往不是配置錯(cuò)了而是第二個(gè)節(jié)點(diǎn)的審批人角色沒有分配具體人員系統(tǒng)不知道該找誰審批。創(chuàng)建角色、分配用戶、再綁定流程節(jié)點(diǎn)這三步環(huán)環(huán)相扣。3.2 考勤排班與基礎(chǔ)人事配置考勤是另一個(gè)容易踩坑的模塊。信呼支持固定班制、彈性班制和排班制。固定班制適合朝九晚六的企業(yè)排班制適合需要倒班的制造、客服團(tuán)隊(duì)。先設(shè)置考勤組把人員劃進(jìn)組里再給每個(gè)組配置上下班時(shí)間、午休時(shí)間、遲到早退容忍時(shí)間。外勤人員可以開啟定位打卡或拍照打卡避免“人在外地打不了卡”的扯皮。這里有一個(gè)實(shí)際經(jīng)驗(yàn)不要把遲到容忍時(shí)間設(shè)成0。真跑起來你會發(fā)現(xiàn)公司網(wǎng)絡(luò)慢一秒員工手機(jī)卡幾十秒各種卡點(diǎn)式遲到就會爆發(fā)管理員處理申訴的時(shí)間比你省下的時(shí)間多得多。建議給3到5分鐘彈性把精力放在真正的異?？记谏稀?.3 模塊化場景公告、任務(wù)與資產(chǎn)除了審批和考勤信呼還有不少模塊可以按需啟用。比如公告通知適合發(fā)布制度、放假安排任務(wù)管理適合給下屬分派工作并跟蹤狀態(tài)資產(chǎn)管理適合登記電腦、顯示器這類辦公設(shè)備客戶管理做輕量級的銷售跟進(jìn)也夠用。模塊多了之后可以按部門配置菜單可見性讓財(cái)務(wù)只看報(bào)銷相關(guān)讓人事只看請假入離職避免信息過載。需要提醒的是不要一上來就把所有模塊全開。OA上線最大的失敗不是功能不夠而是功能太多沒人用。先開審批、考勤、公告三件套跑一兩個(gè)月形成習(xí)慣了再逐步開放任務(wù)、資產(chǎn)、客戶效果會好很多。4. 權(quán)限配置與二次開發(fā)切入點(diǎn)4.1 權(quán)限模型與人員權(quán)限配置權(quán)限配置是OA里最容易被忽視、也最容易出問題的地方。信呼的權(quán)限模型可以拆成三層角色權(quán)限能看哪些菜單、能執(zhí)行哪些操作、數(shù)據(jù)權(quán)限能看哪些部門、哪些人產(chǎn)生的數(shù)據(jù)、字段權(quán)限某些敏感字段是否可見。比如財(cái)務(wù)部的報(bào)銷單普通員工只能看自己的財(cái)務(wù)總監(jiān)能看全公司的部門主管能看本部門的。這在信呼里可以通過數(shù)據(jù)范圍來限制。有人會搜“勾股OA配置人員權(quán)限”其實(shí)道理都是一樣的先在后臺創(chuàng)建角色勾選模塊和操作權(quán)限然后把用戶加入角色。信呼里還多了一個(gè)維度用戶歸屬于哪個(gè)部門會影響他在審批流里的身份和能處理的數(shù)據(jù)范圍。所以配置順序一般先建部門、再建角色、再分配用戶、最后按流程節(jié)點(diǎn)綁定審批角色。漏了任何一環(huán)都會出現(xiàn)“有權(quán)限的人看不到數(shù)據(jù)沒權(quán)限的人反而一清二楚”的怪現(xiàn)象。另外經(jīng)常有人問泛微OA崗位表是哪張其實(shí)在信呼里這個(gè)問題要簡單得多。部門、崗位、角色是三個(gè)后臺頁面直接維護(hù)的概念不需要去翻數(shù)據(jù)表結(jié)構(gòu)。人員掛在部門下崗位決定職責(zé)標(biāo)簽角色決定操作權(quán)限三者配合起來就是一套很清晰的權(quán)限體系。4.2 二次開發(fā)與外部系統(tǒng)集成信呼用的是經(jīng)典PHP MVC結(jié)構(gòu)對會PHP的開發(fā)者來說二次開發(fā)門檻不高。最常見的是改表單字段、調(diào)樣式、加打印模板這些在源碼里搜索中文關(guān)鍵詞基本能定位到對應(yīng)模板。更進(jìn)階一點(diǎn)可以寫自己的模塊掛在系統(tǒng)菜單里。要注意的是升級官方版本時(shí)會覆蓋文件如果改了核心文件最好把改動整理成補(bǔ)丁或者用 Git 維護(hù)一份自己的分支否則下次升級會把你辛辛苦苦改的代碼沖掉。對外集成方面v1.8.6 支持通過 API 接口把 OA 數(shù)據(jù)和外部系統(tǒng)打通。我做過一個(gè)場景把企業(yè)微信的審批消息直接推送到對應(yīng)審批人員工在企業(yè)微信里點(diǎn)開鏈接就能處理不用專門登錄 OA 后臺。類似的還有釘釘、企業(yè)微信的組織架構(gòu)同步人員入職離職后在 OA 里維護(hù)好部門成員推送到外部平臺。定時(shí)任務(wù)則依賴服務(wù)器的 crontab比如每天凌晨同步數(shù)據(jù)、清理緩存、發(fā)送日報(bào)摘要。在 crontab 里加一行0 2 * * * php /var/www/html/xinhu/cron.php /dev/null 21具體腳本路徑要看自己的目錄結(jié)構(gòu)重點(diǎn)是讓任務(wù)跑在低峰期并且輸出日志方便排查。5. 避坑實(shí)錄常見問題與排查方法這部分是我最想分享的。信呼這種開源系統(tǒng)網(wǎng)上資料不少但真正卡住人的往往是環(huán)境細(xì)節(jié)。我把實(shí)際遇到的問題整理成一張速查表按出現(xiàn)頻率排了個(gè)序。5.1 安裝與運(yùn)行類問題現(xiàn)象可能原因排查思路安裝頁打不開PHP擴(kuò)展缺失或版本不兼容用php -m看擴(kuò)展查看 PHP error log安裝完成后白屏目錄權(quán)限不足或緩存未寫入檢查 runtime、upload 目錄可寫清 PHP 緩存登錄后菜單404Nginx 偽靜態(tài)沒配按 2.2 節(jié)配置 rewrite 并重載 Nginx數(shù)據(jù)庫連接失敗數(shù)據(jù)庫主機(jī)、端口、賬號不對用命令行mysql -u 賬號 -p試連確認(rèn)權(quán)限上傳附件失敗upload 目錄不可寫chmod 755 upload確認(rèn)屬主是 www 用戶這五個(gè)問題里前三個(gè)占了我遇到的八成。特別是 PHP 版本如果看到像mysql_connect()這類函數(shù)不存在別懷疑就是 PHP 版本太高老代碼的兼容性問題。換回 PHP 7.4 基本能解決。5.2 流程與數(shù)據(jù)類問題流程不按預(yù)設(shè)走幾乎是每個(gè)企業(yè)剛上線時(shí)的常態(tài)。最常見的兩個(gè)原因一是節(jié)點(diǎn)審批人角色沒有綁定具體員工二是員工離職或調(diào)崗后部門結(jié)構(gòu)變了原來設(shè)定的責(zé)任人失效。排查路徑是到后臺流程管理里看“當(dāng)前處理人”如果為空說明角色沒有匹配到人如果有人就看對方賬號是否還在正常狀態(tài)有沒有被停用。還有一類問題是數(shù)據(jù)不對比如報(bào)銷單填了金額統(tǒng)計(jì)報(bào)表里卻查不到。先查是不是表單字段沒有正確映射到統(tǒng)計(jì)字段再查該部門的數(shù)據(jù)權(quán)限范圍配置。數(shù)據(jù)權(quán)限太嚴(yán)會導(dǎo)致部門主管看不到下屬的單子。這個(gè)在權(quán)限配置里調(diào)整范圍后重新測試即可。5.3 安全與性能問題OA 系統(tǒng)有個(gè)容易被忽視的安全點(diǎn)入口文件。安裝完一定要把 install 相關(guān)文件刪掉另外后臺入口盡量不要用默認(rèn)路徑。我的習(xí)慣是把后臺路徑改成長隨機(jī)字符串這樣即使有人掃描到系統(tǒng)指紋也沒法直接暴力猜后臺地址。再配合 HTTPS 和強(qiáng)密碼基本能擋住大部分麻煩。性能方面中小企業(yè)規(guī)模一般跑不到瓶頸。真到了幾千人同時(shí)在線的時(shí)候優(yōu)先看數(shù)據(jù)庫慢查詢給常用的流程表單表建索引再往前一步可以用 Redis 做會話緩存減輕 PHP 進(jìn)程壓力。但這些優(yōu)化都不是 v1.8.6 剛需絕大多數(shù)團(tuán)隊(duì)不需要一上來就搞。6. 和幾款主流OA放在一起怎么選6.1 橫向?qū)Ρ痊F(xiàn)在 OA 市場挺熱鬧除了信呼這種開源 PHP OA還有不少商業(yè)產(chǎn)品。我把幾款在熱搜里常出現(xiàn)的放一起做個(gè)對比方便你心里有數(shù)。對比項(xiàng)信呼OA v1.8.6點(diǎn)獅OA PointLion藍(lán)凌OA泛微OA致遠(yuǎn)OA部署方式私有化部署PHPMySQL私有化部署為主私有化或云部署私有化或云部署私有化或云部署定位中小團(tuán)隊(duì)、開源、輕量化企業(yè)級定制交付知識管理與協(xié)同辦公大型組織流程管控政務(wù)與大型企業(yè)授權(quán)成本開源免費(fèi)商業(yè)授權(quán)商業(yè)授權(quán)商業(yè)授權(quán)商業(yè)授權(quán)實(shí)施門檻低自己部署需要廠商實(shí)施較高重實(shí)施高重咨詢服務(wù)高重實(shí)施流程引擎夠用適合標(biāo)準(zhǔn)流程偏定制靈活非常強(qiáng)強(qiáng)二次開發(fā)基于PHP社區(qū)資料多看廠商開放程度有開放平臺API完善但學(xué)習(xí)成本高有開放平臺表里的評價(jià)是基于我接觸到的項(xiàng)目感受不代表所有場景。藍(lán)凌在知識庫、文檔協(xié)同上有積累泛微在超大型組織的復(fù)雜流程上非常成熟致遠(yuǎn)在政務(wù)和大型國企場景常見。點(diǎn)獅OA 我實(shí)際項(xiàng)目接觸不多所以只標(biāo)注了企業(yè)級定制交付這個(gè)方向具體選型還要看當(dāng)?shù)貜S商方案。6.2 我的選型建議如果你的團(tuán)隊(duì)在幾十人規(guī)模流程主要是請假、報(bào)銷、用章、合同審批沒有專門的 IT 團(tuán)隊(duì)但有愿意學(xué)的同事信呼OA完全夠用。先把標(biāo)準(zhǔn)流程跑通后續(xù)再做二次開發(fā)。如果企業(yè)到了幾百人、有多個(gè)事業(yè)部、審批規(guī)則很復(fù)雜那泛微、藍(lán)凌這類商業(yè)產(chǎn)品的流程引擎和組織模型會更省心前提是預(yù)算和項(xiàng)目周期都夠。很多人喜歡問“哪個(gè)OA最好”我的回答是先想清楚你最痛的是哪個(gè)場景。最痛的是報(bào)銷審批慢就找一個(gè)能把審批玩明白的系統(tǒng)最痛的是各部門信息孤島就考慮知識協(xié)同和門戶更強(qiáng)的產(chǎn)品。工具是拿來解決問題的不是拿來做功能對比展覽的。最后說一點(diǎn)我的個(gè)人習(xí)慣。每次給客戶布置完信呼我都會在后臺建一個(gè)測試賬號專門用來走一遍請假、報(bào)銷、會議紀(jì)要這三條高頻流程。系統(tǒng)改過配置、升過級或者開發(fā)改過代碼就用這個(gè)賬號把流程全跑一遍比看多少日志都管用。另一個(gè)習(xí)慣是動數(shù)據(jù)庫或改核心文件之前永遠(yuǎn)先備份。信呼的數(shù)據(jù)文件其實(shí)就是 MySQL 庫加上附件目錄把這個(gè)目錄和數(shù)據(jù)庫導(dǎo)出一個(gè)備份加起來也不大但出事的時(shí)候就是救命稻草。這套習(xí)慣幫我避過不少坑希望你也能用上。本文還有配套的精品資源點(diǎn)擊獲取