PyPy插件

要求uWSGI >= 2.0.9

介绍

想法/设计：Maciej Fijalkowski

贡献者：Alex Gaynor, Armin Rigo

自uWSGI 1.9.11起，就有了一个基于cffi的PyPy插件。老且慢的基于cpyext的已经从版本树中移除了。

目前，只在Linux系统上支持该插件。接下来的发布版本也会支持其他平台。

这个插件在启动的时候加载 libpypy-c.so ，设置PyPy安装目录，并且执行一个实现插件逻辑的特别的Python模块。所以是哒，大多数的插件都是用Python实现的，并且理论上讲，这个方法将允许除了C, C++和Objective-C之外，直接用Python编写uWSGI插件。

截至2014年12月，已经合并了到PyPy的所有所需插件，因此你可以获取一个官方最新版本 (或者一个于2014年12月后发布的稳定版本)，然后与uWSGI一起使用它。

安装带PyPy支持的uWSGI

与往常一样，使用uWSGI，你有不同的方法基于你的需求安装uWSGI。

如果你已在PyPy家目录安装了pip，那么可以运行

pip install uwsgi

这个uwsgi setup.py文件将会识别PyPy环境，并且构建一个仅PyPy的uWSGI二进制文件。

使用相同的方式，你可以执行uWSGI源码中提供的setup.py：

pypy setup.py install

(这两种方法将会把pypy家目录硬编码到uWSGI二进制文件中，因此，你无需在你的选项中设置pypy-home)

或者你可以手工编译：

UWSGI_PROFILE=pypy make

或者可以使用网络安装程序：

curl https://uwsgi.it/install | bash -s pypy /tmp/uwsgi

这将会在 /tmp/uwsgi 中构建一个uWSGI + PyPy二进制文件

或者你可以把PyPy支持当成插件构建。

uwsgi --build-plugin plugins/pypy

或者(旧式)

python uwsgiconfig.py --plugin plugins/pypy

PyPy家目录

uWSGI Python插件 (更准确的说，是CPython插件) 通过链接 libpython 工作。这意味着，对于Python的每一个不同的版本，你都需要重新构建这个插件。而这个PyPy插件不同，因为libpypy-c是在启动时加载的，而它的符号在运行时解决。这允许你动态迁移到一个不同的PyPy版本。

这个方法的“缺点”是，你需要在运行时通知uWSGI你的PyPy安装在哪里 (除非你是通过pip或者使用setup.py脚本来安装uwsgi的，在这样的情况下，会自动找到家目录)

假设你的PyPy位于 /opt/pypy ，你可以这样启动uWSGI：

uwsgi --http-socket :9090 --pypy-home /opt/pypy

通过这个命令行，uWSGI将会搜索 /opt/pypy/bin/libpypy-c.so ，如果找到，它将会设置那个路径为PyPy家目录。

如果你的 libpypy-c.so 位于PyPy家目录之外 (并且位于一个动态链接器不可达的目录中)，那么你可以使用 --pypy-lib 选项。

uwsgi --http-socket :9090 --pypy-home /opt/pypy --pypy-lib /opt/libs/libpypy-c.so

通过这个方法，你可以使用来自一个指定PyPy构建的库，以及来自其他的家目录。

注解

如果你想指向当前目录下的一个.so文件，那么记得给–pypy-lib加上前缀./！

PyPy设置文件

如前所述，大多数的uWSGI PyPy插件都是用Python写的。该代码于运行时加载，你也可以自定义它。

是哒，这就意味着你无需重新构建uWSGI就可以改变这个插件的工作方式。

pypy_setup.py 文件的默认版本被嵌入到uWSGI二进制文件中，而它自动在启动时加载。

如果你想改变它，那么仅需通过 --pypy-setup 选项传递另一个文件名。

uwsgi --http-socket :9090 --pypy-home /opt/pypy --pypy-lib /opt/libs/libpypy-c.so --pypy-setup /home/foobar/foo.py

这个Python模块实现了uWSGI钩子和用于访问来自你的应用的uWSGI API的虚拟 uwsgi python模块。

如果你想要检索嵌入的pypy_setup.py文件的内容，那么你可以通过使用 print-sym 这个便捷选项来从二进制符号中读取它。

uwsgi --print-sym uwsgi_pypy_setup

WSGI支持

该插件实现了PEP 333和PEP 3333。你可以同时加载WSGI模块和 mod_wsgi 样式的 .wsgi 文件。

要加载一个WSGI模块 (它必须位于你的Python路径中)：

uwsgi --http-socket :9090 --pypy-home /opt/pypy --pypy-wsgi myapp

要加载一个WSGI文件：

uwsgi --http-socket :9090 --pypy-home /opt/pypy --pypy-wsgi-file /var/www/myapp/myapp.wsgi

RPC支持

你可以使用 uwsgi.register_rpc() API函数来注册RPC函数，就像你可以使用普通的Python插件一样。

import uwsgi

def hello():
    return "Hello World"

uwsgi.register_rpc('hello', hello)

要调用RPC函数， uwsgi.rpc() 和 uwsgi.call() 都可以用。

import uwsgi

uwsgi.rpc('192.168.173.100:3031', 'myfunc', 'myarg')
uwsgi.call('myfunc', 'myarg')
uwsgi.call('[email protected]:3031', 'myarg')

(与本地RPC) 集成已经在PyPy和PyPy, PyPy和JVM, 以及PyPy和Lua之前测试过了。所有这些都工作得十分完美……因此，那意味着你可以调用来自PyPy的Java函数。

IPython技巧

用一个用于测试的运行中的shell是非常非常棒的。你可以使用IPython来实现。

uwsgi --socket :3031 --pypy-home /opt/pypy --pypy-eval "import IPython; IPython.embed()" --honour-stdin

选项

  • pypy-lib - 加载指定的libpypy-s.so
  • pypy-setup - 加载指定的pypy_setup脚本文件
  • pypy-home - 设置pypy家目录
  • pypy-wsgi - 加载一个WSGI模块
  • pypy-wsgi-file - 加载一个mod_wsgi兼容的.wsgi文件
  • pypy-eval - 在 fork() 之前执行指定的字符串
  • pypy-eval-post-fork - 在每个 fork() 之后执行指定的字符串
  • pypy-exec - 在 fork() 之前执行指定的python脚本
  • pypy-exec-post-fork - 在每个 fork() 之后执行指定的python脚本
  • pypy-pp/pypy-python-path/pypy-pythonpath - 添加指定项到pythonpath
  • pypy-paste - 加载一个paste.deploy .ini配置
  • pypy-ini-paste - 加载一个paste.deploy .ini配置，并使用它的[uwsgi]部分

注意事项

  • 混合libpython和libpypy-c是明确禁止的。pypy插件中的检查阻止你做这种地狱般的事情。
  • 从一个Python程序员的观点来看，PyPy插件一般较为“正统”，而CPython在许多领域也许有点亵渎。我们已经能够进行抉择了，因为我们无需向后兼容较老的uWSGI发行版。
  • uWSGI API仍然未完成
  • WSGI加载器并不更新uWSGI内部应用列表，因此，诸如 --need-app 这样的东东并不能用。即使应用已成功被加载，服务器也会在启动时报告”dynamic mode”。这将会很快被修复。